SoftSlate Commerce
Home » Documentation » HTML Documentation

Eclipse

As of this writing among Java IDEs, Eclipse is the most popular. It is a free, open-source application, and runs on Windows, Linux, Mac OS X, and other platforms. It provides great support for Java development, and has an extensive network of plug-in developers.

As of version 3.0.3, it is possible to import SoftSlate Commerce into Eclipse as a ready-made project:

  1. Download the SoftSlate Commerce .zip file to your local workstation.

  2. Visit www.eclipse.org to download Eclipse for your platform. It is free and runs on multiple operating systems. Follow the instructions on www.eclipse.org to install Eclipse. We strongly recommend you download the "Eclipse IDE for Java EE Developers" package for its Web Tools support, which includes JSP systax highlighting, among many other things.

  3. In Eclipse, go to File -> Import..., open up the General tab and select "Existing Projects into Workspace".

  4. Choose the "Select archive file" option and browse to find the SoftSlate Commerce .zip file.

  5. Click Finish. Eclipse should unzip and build the project and you're ready to start developing!

  6. When you're ready to deploy changes, you can simply choose File -> Export ... -> Web -> War file to generate a .war file that may be deployed anywhere.

[Note]Note

It is also possible to integrate Eclipse with Tomcat and run SoftSlate Commerce under Eclipse in Debug mode, which allows for hot swapping code changes, breakpoints and other features. To do this, create and configure a "Server" in Eclipse and add the project as a web module to the Server.

To use Eclipse with SoftSlate Commerce under an existing Tomcat instance, follow these steps:

  1. Install SoftSlate Commerce. 

    If you haven't already, install SoftSlate Commerce on your development computer, following the steps outlined in the chapter on Installing SoftSlate Commerce. Note that the license allows you to install SoftSlate Commerce on any number of development machines that are inaccessible to the public.

  2. Download and Install Eclipse. 

    Visit www.eclipse.org to download Eclipse for your platform. It is free and runs on multiple operating systems. Follow the instructions on www.eclipse.org to install Eclipse. We strongly recommend you download the "Eclipse IDE for Java EE Developers" package for its Web Tools support, which includes JSP systax highlighting, among many other things.

  3. Create a New Java Project. 

    Once Eclipse is installed, create a new Java project pointing to the the directory where SoftSlate Commerce is installed on your local computer. Go to File -> New -> Project, select Java Project and click next, give the project any name you like, and then select "Create project from existing source" and find the SoftSlate Commerce installation directory.

  4. Configuration Settings. 

    As of version 3.0.3, Eclipse should automatically configure SoftSlate Commerce correctly when you first create the project. In case it does not, check the "Java Build Path" settings for the project to make sure they are correct:

    • Go to the File -> Properties -> Java Build Path screen.
    • Under the "Source" tab, add the <installation-drectory>/WEB-INF/src directory as the application's only source folder.
    • Under the same tab, make sure the "default output directory" is <installation-drectory>/WEB-INF/classes .
    • Next, under the "Libraries" tab, click the "Add JARs" button and check off all of the .jar files under the WEB-INF/lib and the WEB-INF/build directories.

    When you're done configuring these settings, Eclipse should be able to successfully compile the application. You'll be off and running.

[Note]Note

If you plan to use the Tomcat as your application server, we suggest pointing your Eclipse project to the same directory Tomcat uses for the application (under Tomcat's webapps directory). Since Eclipse compiles your Java code as you save each file, this prevents you from having to compile manually before testing your changes. A simple restart of Tomcat is all you need to do.

Copyright © 2009-2017 SoftSlate, LLC. All Rights Reserved.

Powered by SoftSlate Commerce

Foraker Design