Building the Library

• Steps to Build
• Build Output
• Running the Test Application
• Running the Hello World Application

Steps to Build

1. Comfirm you have a working version of Ant installed.
2. Download the source jar from SourceForge.
3. Extract the code from the source jar. It will expand into a folder called YetAnotherSwingLib with the following files and sub-folders:
   • build.xml
   • /deployment
   • /lib (This folder is a placeholder for future use.)
   • /logging-props
   • /source
   • /source-slf4j
4. Execute the following in the same folder as build.xml: ant build. The build.xml file has the following targets:
   • api: creates API documentation in the JavaDoc format.
   • build: compiles all source files and creates all jars.
   • clean: removes all files created by the build.
   • clean-build: executes clean then build.

Build Output

The output from the build will be located in the deployment folder. The build will create five jar files:

• yasl-arch-1.2.jar: contains all the classes required to implement the architecture. The packages included are: org/yasl/arch, org/yasl/xmlobjects, and org/yasl/util/YASLResourceBundleHelper.class.
• yasl-slf4j-1.2.jar: contains all the classes required for the yasl implementation of slf4j. The packages included are: org/slf4j, org/yasl/logging/interfaces, and org/yasl/logging/impl.
• yasl-components-1.2.jar: contains all the classes for the component library. The packages included are: org.yasl.about, org.yasl.componentlist, org.yasl.debugging, org.yasl.jars, org.yasl.layout, org.yasl.logging.component, org.yasl.logging.interfaces, org.yasl.tables, org.yasl.text, org.yasl.util, and org.yasl.xmlobjects.
• yasl-testapp-1.2.jar: contains the classes, xml config, and properties required to run the test application. The packages and files included are: org/yasl/testapp, yaslslf4jlogging.properties, and manifest.testapp.mf.
• yasl-helloworld-1.2.jar: contains the classes, xml config, and properties required to run the hello world application. The packages and files included are: org/yasl/helloworld, yaslslf4jlogging.properties, and manifest.helloworld.mf.

Running the Test Application

The sole purpose of this application is to test components and architecture features. Note that the test application depends on the slf4j jar and the other three yasl jars. These jars (slf4j-api-1.4.3.jar; yasl-arch-1.0.jar; yasl-slf4j-1.0.jar; yasl-components-1.0.jar) must be in the same folder as the test application jar.

Use the following command to run the test application:
java -Dyasl.app.config.file=/org/yasl/testapp/yaslAppConfig.properties -jar yasl-testapp-1.2.jar

Running the Hello World Application

The sole purpose of this application is to test the architecture with a minimum amount of code. It's a bare bones YASL application. For a detailed description of the Hello World Application's components, see Quick Start: Hello World. Note that the hello world application depends on the slf4j.jar and two other yasl jars. These jars (slf4j-api-1.4.3.jar; yasl-arch-1.0.jar; and yasl-slf4j-1.0.jar) must be in the same folder as the test application jar.

Use the following command to run the hello world application:
java -jar yasl-helloworld-1.2.jar