Developing new JASigning Apps - Revision history

John.Glauert at 11:17, 5 September 2017

2017-09-05T11:17:52Z

← Older revision		Revision as of 11:17, 5 September 2017
Line 1:		Line 1:
	[[Home]] >> [[JASigning]]		[[Main Page\|Home]] >> [[JASigning]]
	----		----
	= Developing new JASigning Apps =		= Developing new JASigning Apps =
Line 37:		Line 37:
	<code>JASApp.jar</code> and the <code>lib</code> folder containing runtime <code>jar</code> files could be placed elsewhere as long as suitable parameters are provided to locate data files. Note that URLs can be used so data for the standard release can be accessed.		<code>JASApp.jar</code> and the <code>lib</code> folder containing runtime <code>jar</code> files could be placed elsewhere as long as suitable parameters are provided to locate data files. Note that URLs can be used so data for the standard release can be accessed.
	----		----
	[[Home]] >> [[JASigning]]		[[Main Page\|Home]] >> [[JASigning]]

John.Glauert: /* Developing new Apps */

2015-05-26T16:36:12Z

Developing new Apps

← Older revision		Revision as of 16:36, 26 May 2015
Line 17:		Line 17:
	The classes in <code>use-jarp</code> create GUIs for the apps and then accept SiGML data on a socket, or play SiGML files specified by URLs. By copying and modifying an existing class, new apps can be built with access to the main methods used by apps and applets.		The classes in <code>use-jarp</code> create GUIs for the apps and then accept SiGML data on a socket, or play SiGML files specified by URLs. By copying and modifying an existing class, new apps can be built with access to the main methods used by apps and applets.

	Assuming that the installation is in a directory <code>loc2015</code> the ~~Netneans~~ project is <code>loc2015/JASApp</code>. Netbeans will create		Assuming that the installation is in a directory <code>loc2015</code> the Netbeans project is <code>loc2015/JASApp</code>. Netbeans will create
	<code>loc2015/JASApp/dist/JASApp.jar</code>. To use the application outside Netbeans, a command such as:		<code>loc2015/JASApp/dist/JASApp.jar</code>. To use the application outside Netbeans, a command such as:
	java -Djava.library.path=jas-libs -Dlog4j.configurationFile=../log4j2.xml -jar dist/JASApp.jar \		java -Djava.library.path=jas-libs -Dlog4j.configurationFile=../log4j2.xml -jar dist/JASApp.jar \

John.Glauert: Initial version.

2015-05-24T17:58:46Z

Initial version.

New page

[[Home]] >> [[JASigning]]
----
= Developing new JASigning Apps =

The standard [[JASigning]] installation at [http://vhg.cmp.uea.ac.uk/tech/jas/std/ JASigning Current Release] provides access to Javadoc files for some of the key
modules of the avatar signing system. It also provides access to the source code for <code>use-jarp</code> which contains classes
for the main example applications and applets.

== Downloading and Building Freestanding [[JASigning]] Apps ==

A version of the [[JASigning]] installation configured for a server running on <code>localhost</code> is documented at [[JASigning Local Installation]] with instructions for downloading and installation.

Within the installation is a NetBeans project <code>JASApp</code> containing the <code>use-jarp</code> sources and configured to access the <code>jar</code> files containing the main [[JASigning]] classes. A few project properties may need to be adjusted to build the project on a user's system. The code is compiled using Java 1.7. It should be possible to make a clean build of the project and run the <code>SiGMLPlayer</code> app.

== Developing new Apps ==

The classes in <code>use-jarp</code> create GUIs for the apps and then accept SiGML data on a socket, or play SiGML files specified by URLs. By copying and modifying an existing class, new apps can be built with access to the main methods used by apps and applets.

Assuming that the installation is in a directory <code>loc2015</code> the Netneans project is <code>loc2015/JASApp</code>. Netbeans will create
<code>loc2015/JASApp/dist/JASApp.jar</code>. To use the application outside Netbeans, a command such as:
java -Djava.library.path=jas-libs -Dlog4j.configurationFile=../log4j2.xml -jar dist/JASApp.jar \
-session file:../SiGMLPlayer -ja.version.tag=loc2015 -ja.remote.base.url=file:../../loc2015/
can be used from the <code>JASApp</code> directory. For information on arguments see [[Passing Arguments to JASigning Apps]].

== Implementation Details ==

The following information from the [[JASigning]] installation directory is used when building apps in the NetBeans project:
* <code>jar</code> files from the <code>jars</code> folder
* <code>jar</code> files from the <code>jogl</code> folder

When run from the <code>JASApp</code> directory with the parameters shown above, the following data is accessed
from the installation directory:
* Avatar definitions from the <code>avatars</code> folder
* Application properties from the installation directory
* Logging configuration from the installation directory

<code>JASApp.jar</code> and the <code>lib</code> folder containing runtime <code>jar</code> files could be placed elsewhere as long as suitable parameters are provided to locate data files. Note that URLs can be used so data for the standard release can be accessed.
----
[[Home]] >> [[JASigning]]