Author: niclas Date: Wed Aug 4 11:38:52 2004 New Revision: 35690 Modified: avalon/trunk/planet/facilities/http/blocks/demo/README.TXT Log: More info about demo.
Modified: avalon/trunk/planet/facilities/http/blocks/demo/README.TXT ============================================================================== --- avalon/trunk/planet/facilities/http/blocks/demo/README.TXT (original) +++ avalon/trunk/planet/facilities/http/blocks/demo/README.TXT Wed Aug 4 11:38:52 2004 @@ -1,11 +1,90 @@ - -To test the server: - -$ ant -$ merlin target\deliverables\blocks\avalon-http-demo-SNAPSHOT.block -config etc\config.xml - -or - -$ merlin artifact:block:avalon/http/avalon-http-demo#SNAPSHOT -config etc\config.xml - - + +HTTP DEMO README +---------------- + +The demo project demonstrates the setup of a http server and context within which +he handle the serving of static and dynamic content. The block for this project is +declared with the build.xml file and covers the inclusion of the http server block, +the inclusion of a context containing a static handler, redirect handler, model +handler and a number of error handlers. Finally, the block contains a component +that we use to handle some dynamic content: + + <x:block name="demo"> + <x:include name="server" artifact="block:avalon/http/avalon-http-server#SNAPSHOT"/> + <x:include name="static-context" artifact="block:avalon/http/avalon-http-static#SNAPSHOT"/> + <x:component name="hello" class="org.apache.avalon.playground.HelloComponent"/> + </x:block> + +The block is configured using the a targets file. The file includes three target +overrides, one dealing with the context definition, the second demonstrating some +redirection capability, and the third demonstrating http path to component path +mapping. + +The static content handler is configured to use the current directory as the default +root content basedir (signified by the context-path and resource-base element value). + + <target path="/demo/static-context/context"> + <configuration> + <context-path>/</context-path> + <resource-base>.</resource-base> + </configuration> + </target> + +The following target overrides the configuration for a url forwarding handler. It +simply forwards a 'from' path to a 'to' path. For example, if you enter a url such +as http://localhost/src/java you will be redirected to http://localhost/src/main. + + <target path="/demo/static-context/forward-handler"> + <configuration> + <forwards> + <forward> + <from>/src/java</from> + <to>/src/main</to> + </forward> + </forwards> + </configuration> + </target> + +The following target override directs incomming urls with the path '/hello' to the +component at the address '/demo/hello'. + + <target path="/demo/static-context/model-handler"> + <parameters> + <parameter name="context-path" value="/hello"/> + <parameter name="target" value="/demo/hello"/> + </parameters> + </target> + +</targets> + +To build the server do the following: + + $ cd avalon <--- your root avalon/trunk directory + $ ant <--- build al of avalon + $ cd planet\facilities\http\blocks + $ ant + $ cd demo + +To test the server you can either execute the generated block from the local file system +of from magic's repository. + +Executing the block from the local filesystem: + + $ merlin target\deliverables\blocks\avalon-http-demo-SNAPSHOT.block -config etc\config.xml + +Executing the block from the repository (the following assumes that you have merlin.repository +referencing the magic repository) + + $ merlin artifact:block:avalon/http/avalon-http-demo#SNAPSHOT -config etc\config.xml + +Open a browser and enter the following url: + + http://localhost:8080 + +You should see the contents of the local directory in your browser. + + http://localhost:8080/hello + +You should see a simple "Hello" message created by the HelloComponent. + +SJM --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
