Skip to content
JetS3t (pronounced "jet-set") is a free, open-source Java toolkit and application suite for Amazon Simple Storage Service (Amazon S3), Amazon CloudFront content delivery network, and Google Storage for Developers.
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cockpit Pulled in changes from the source repo tip-of-the-tree. Added CORS pa… Nov 9, 2018
cockpitlite Pulled in changes from the source repo tip-of-the-tree. Added CORS pa… Nov 9, 2018
gatekeeper
jets3t-gui Pulled in changes from the source repo tip-of-the-tree. Added CORS pa… Nov 9, 2018
jets3t Updated logger for slf4j style. Fixed GoogleStorage CORS puts May 21, 2019
synchronize Pulled in changes from the source repo tip-of-the-tree. Added CORS pa… Nov 9, 2018
uploader Updated uploader Nov 9, 2018
.gitignore Added local scripts to ignores Dec 3, 2018
LICENSE Initial commit Oct 31, 2018
NOTICE.txt First commit of restructured projects Oct 31, 2018
README.md Update README.md Dec 3, 2018
RELEASE_NOTES.md Update RELEASE_NOTES.md Oct 31, 2018
jets3t-formatter.xml Pulled in changes from the source repo tip-of-the-tree. Added CORS pa… Nov 9, 2018
pom.xml Pulled in changes from the source repo tip-of-the-tree. Added CORS pa… Nov 9, 2018

README.md

JetS3t

Disclaimer

This is a fork and continuation of the original JetS3t project by James Murty.

Overview

JetS3t is a free, open-source Java toolkit and application suite for Amazon Simple Storage Service (Amazon S3), Amazon CloudFront content delivery network, and Google Storage for Developers.

For further information, documentation, and links to discussion lists and other resources, please visit the JetS3t web site. There are also historic release notes summarizing the changes in past JetS3t releases, and pending release notes that include details about the up-coming release.

Running Applications

Each application can be run using a script in the bin directory. To run an application, such as Cockpit, run the appropriate script from the bin directory for your JetS3t version ("x.y.z" in these examples).

Windows:

cd jets3t-x.y.z\bin
cockpit.bat

Unixy:

bash jets3t-x.y.z/bin/cockpit.sh

Configuration files

Applications or library components generally read text configuration files, which must be available in the classpath of a running application to be useful.

Example configuration files are located in the configs directory. The run scripts in the bin directory automatically include this configs directory in the classpath when running JetS3t apps.

The configuration files include:

  • jets3t.properties Low-level toolkit configuration.
  • synchronize.properties Properties for the Synchronize application
  • uploader.properties Properties for the Uploader application
  • cockpitlite.properties Properties for the CockpitLite application
  • mime.types Maps file extensions to the appropriate mime/content type. For example, the "txt" extension maps to "text/plain".
  • commons-logging.properties Defines which logging implementation to use.
  • log4j.properties When Log4J is the chosen logging implementation, these settings control how much logging information is displayed, and the way it is displayed.
  • simplelog.properties When SimpleLog is the chosen logging implementation, these settings control the logging information that is displayed.

JAR files

The compiled JetS3t code jar files are available in the jars directory, and include the following:

  • jets3t-x.y.z.jar

    The JetS3t toolkit, including the JetS3t service implemention which underlies all the other JetS3t applications.

  • jets3t-gui-x.y.z.jar

    Graphical user interface components used by JetS3t GUI applications such as Cockpit. These components are not required by the command-line Synchronize tool, nor by non-graphical programs you may build.

  • cockpit-x.y.z.jar

    Cockpit, a GUI application/applet for viewing and managing the contents of an S3 account.

  • synchronize-x.y.z.jar

    Synchronize, a console application for synchronizing directories on a computer with an Amazon S3 account.

  • cockpitlite-x.y.z.jar

    CockpitLite, a GUI application/applet for viewing and managing the contents of an S3 account, where the S3 account is not owned by the application's user directly but is made available via the Gatekeeper servlet.

  • uploader-x.y.z.jar

    Uploader, a wizard-based GUI application/applet that S3 account holders (Service Providers) may provide to clients to allow them to upload files to S3 without requiring access to the Service Provider's S3 credentials

Compatibility and Performance of Distributed Jar files

The class files in these jars are compiled for compatibility with Sun's JDK 8 and later, and have debugging turned on to provide more information if errors occur.

To use JetS3t in high-performance scenarios, the classes should be recompiled using the latest version of Java available to you and with debugging turned off.

Building JetS3t from source

The JetS3t distribution package is built using Maven.

The following command will recompile the JetS3t library and applications: mvn clean package

JetS3t applications or applets may not be building correctly as of project takeover, but they will be soon. If you encounter issues with the current builds starting with 0.9.6-SNAPSHOT please file issue reports.

Maven

  <dependency>
      <groupId>org.jets3t</groupId>
      <artifactId>jets3t</artifactId>
      <version>0.9.6-SNAPSHOT</version>
  </dependency>

Direct downloads

Snapshots Releases

Servlets

The JetS3t application suite includes a servlet implementation of a Gatekeeper to offer mediated third-party access to your S3 resources. The deployable WAR file for this servlet is located in the servlets/gatekeeper directory.

You can’t perform that action at this time.