# -----------------------------------------------------------------------------
# howto_use.txt
#
# $Id: howto_use.txt,v 1.5 2004/01/26 07:30:48 miyachi Exp $
# -----------------------------------------------------------------------------

*HowTo for use "Cactus4Enhydra" for "YOUR PROJECT".

	+---------------------------------------------------------------+
	|	*Of course, it is necessary to build "Cactus4Enhydra"	|
	|	on YOUR ENVIRONMENT in advance. 			|
	|								|
	|	*Please make Sample Project reference.			|
	+---------------------------------------------------------------+

	 In order to use "Cactus4Enhydra" for "YOUR PROJECT",
	it is necessary to create the following items.

		*ant.sh
		*ant-test.sh
		*build.properties
		*cactus.properties
		*build.xml
		*input/conf/YOUR PROJECT.conf
		*src/YOUR PACKAGE/presentation/EnhydraAppRedirector.java

	*Create your LOCAL "ant.sh".

		 Please create LOCAL "ant.sh" for "YOUR ENVIRONMENT".
		 Please see "ant.sh.sample".

	*Create your LOCAL "ant-test.sh".

		 Please create LOCAL "ant.sh" for "YOUR ENVIRONMENT".
		 Please see "ant-test.sh.sample".

		Note: ant-test.sh  differs from a little ant.sh. 

	*Create your "build.properties".

		 Please edit "build.properties" for "YOUR ENVIRONMENT".
		 Please see "build.properties.sample".

	*Create your "cactus.properties".

		 Please edit "cactus.properties" for "YOUR ENVIRONMENT".
		 Please see "cactus.properties.sample".

	*Create your "build-test.xml".

		 Please edit "build-test.xml" for "YOUR ENVIRONMENT".
		 Please see "build-test.xml.sample".

	*Edit "input/conf/YOUR PROJECT.conf.in

		 "Cactus4Enhydra.jar" must be carried out Load as "Context Class" by the specification of "Cactus".
		 Therefore, "Cactus4Enhydra.jar" is added to "Server.ClassPath[]" entry.

		# It took one day to solve this. 

			----------------------------------------------------------------------------------------
			Server.ClassPath[] = "@@PROJECT_ROOT@@/Sample/output/lib/Sample.jar", "@@PROJECT_ROOT@@/Cactus4Enhydra/output/lib/Cactus4Enhydra.jar"
			----------------------------------------------------------------------------------------

		 Please see "input/conf/Sample.conf.in.sample".

	*Create src/YOUR PACKAGE/presentation/EnhydraAppRedirector.java

		 With the specification of "Enhydra", you have to put "EnhydraAppRedirector.java(po)"
		on "src/YOUR PACKAGE/presentation/".

		 Please see "src/Sample/presentation/EnhydraAppRedirector.java".

	*Lets' "clean" and "make".

		 Please use LOCAL "ant.sh"!!

			----------------------------------------------------------------------------------------
			$ ./ant.sh clean
			  ^^^^^^^^^^^^^^
			Buildfile: build.xml

			clean:

			BUILD SUCCESSFUL
			Total time: 3 seconds
			$./ant.sh
			 ^^^^^^^^
			Buildfile: build.xml

			prepare:
			    ...

			dods:

			xmlc:
			    ...

			compile:
			    ...

			archive:
			    ....

			output:
			    ....

			make:

			BUILD SUCCESSFUL
			Total time: 13 seconds
			$
			----------------------------------------------------------------------------------------

	*Lets' "test"

		 Please use LOCAL "ant-test.sh"!!

			$./ant-test.sh
			 ^^^^^^^^^^^^^^
			Buildfile: build-test.xml

			init:

			prepare.test:

			test.enhydra:

			start.enhydra:
			    ....

			test:
			    ....

			stop.enhydra:
			    ....

			BUILD SUCCESSFUL
			Total time: 13 seconds
			$
			----------------------------------------------------------------------------------------