svn commit: r1560011 - /incubator/olingo/site/trunk/content/doc/tutorials/AnnotationProcessorExtension.mdtext

[mi...@apache.org]

Author: mibo
Date: Tue Jan 21 13:52:52 2014
New Revision: 1560011

URL: http://svn.apache.org/r1560011
Log:
CMS commit to olingo by mibo

Modified:
    incubator/olingo/site/trunk/content/doc/tutorials/AnnotationProcessorExtension.mdtext

Modified: incubator/olingo/site/trunk/content/doc/tutorials/AnnotationProcessorExtension.mdtext
URL: http://svn.apache.org/viewvc/incubator/olingo/site/trunk/content/doc/tutorials/AnnotationProcessorExtension.mdtext?rev=1560011&r1=1560010&r2=1560011&view=diff
==============================================================================
--- incubator/olingo/site/trunk/content/doc/tutorials/AnnotationProcessorExtension.mdtext (original)
+++ incubator/olingo/site/trunk/content/doc/tutorials/AnnotationProcessorExtension.mdtext Tue Jan 21 13:52:52 2014
@@ -39,8 +39,16 @@ For more detailed documentation about Ar
 A project which use the Annotation Processor Extension consists mainly of the model beans, the `ODataServiceFactory` implementation and the web resources (e.g. `web.xml`). 
 In addition we use Maven so that it is necessary to create a `pom.xml` for project build information and dependency resolution.
 
+### Creation of Module
+To start a folder is created (e.g. *annotation-from-scratch*) which contains the Maven project.
+Within this the default Maven project structure is used, which looks like:
+
+    ./src/main/java 
+    ./src/main/resources 
+    ./src/main/webapp 
+
 ### Create pom.xml
-A default `pom.xml` for building of an `WAR-File` is created.
+After creation of the project structure the default `pom.xml` for building of an `WAR-File` have to be created.
 In addition we need the dependency to all necessary _Apache Olingo artifacts_ and to the used `JAX-RS` implementation which in this sample is `Apache CXF`.
 
 The resulting `pom.xml` then looks like:
@@ -352,9 +360,16 @@ Therefore the `web.xml` is created in th
 
 
 ### Deploy and Run
-Build the project with maven via `mvm clean package` and copy the resulting `WAR-File` from the projects `target` folder in the `deploy` folder of the application server.
+Build the project with maven via `mvm clean package` and copy the resulting `WAR-File` from the projects `target` folder in the `deploy` folder of the web application server (e.g. a [Tomcat](http://tomcat.apache.org/)).
+As example for a default Tomcat 7.x installation `cp $PROJECT_HOME/target/cars-annotations-sample.war $TOMCAT_HOME/webapps`.
+
+After starting the web application server it is possible to request e.g.
+  * the *Service Document* via the URL: `http://localhost:8080/cars-annotations-sample/AnnotationSample.svc/`
+  * the *Metadata* via the URL: `http://localhost:8080/cars-annotations-sample/AnnotationSample.svc/$metadata`
+  * the *Cars* EntitySet via the URL: `http://localhost:8080/cars-annotations-sample/AnnotationSample.svc/CarSet`
+  * the *Manufacturer* EntitySet via the URL: `http://localhost:8080/cars-annotations-sample/AnnotationSample.svc/ManufacturerSet`
 
-Now just navigate to the URL (e.g. `http://localhost:8080/cars-annotations-sample/AnnotationSample.svc`).
+Also it is possible to create *Car* and *Manufacturer* Entities via `HTTP POST` requests.
 
 ## More detailed look