You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@olingo.apache.org by bu...@apache.org on 2014/01/21 14:52:57 UTC
svn commit: r894959 - in /websites/staging/olingo/trunk/content: ./
doc/tutorials/AnnotationProcessorExtension.html
Author: buildbot
Date: Tue Jan 21 13:52:57 2014
New Revision: 894959
Log:
Staging update by buildbot for olingo
Modified:
websites/staging/olingo/trunk/content/ (props changed)
websites/staging/olingo/trunk/content/doc/tutorials/AnnotationProcessorExtension.html
Propchange: websites/staging/olingo/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Jan 21 13:52:57 2014
@@ -1 +1 @@
-1559106
+1560011
Modified: websites/staging/olingo/trunk/content/doc/tutorials/AnnotationProcessorExtension.html
==============================================================================
--- websites/staging/olingo/trunk/content/doc/tutorials/AnnotationProcessorExtension.html (original)
+++ websites/staging/olingo/trunk/content/doc/tutorials/AnnotationProcessorExtension.html Tue Jan 21 13:52:57 2014
@@ -92,8 +92,17 @@ Therefore Maven must be called as shown
<h2 id="creation-from-scratch">Creation from Scratch</h2>
<p>A project which use the Annotation Processor Extension consists mainly of the model beans, the <code>ODataServiceFactory</code> implementation and the web resources (e.g. <code>web.xml</code>).
In addition we use Maven so that it is necessary to create a <code>pom.xml</code> for project build information and dependency resolution.</p>
+<h3 id="creation-of-module">Creation of Module</h3>
+<p>To start a folder is created (e.g. <em>annotation-from-scratch</em>) which contains the Maven project.
+Within this the default Maven project structure is used, which looks like:</p>
+<div class="codehilite"><pre><span class="o">./</span><span class="n">src</span><span class="o">/</span><span class="n">main</span><span class="o">/</span><span class="n">java</span>
+<span class="o">./</span><span class="n">src</span><span class="o">/</span><span class="n">main</span><span class="o">/</span><span class="n">resources</span>
+<span class="o">./</span><span class="n">src</span><span class="o">/</span><span class="n">main</span><span class="o">/</span><span class="n">webapp</span>
+</pre></div>
+
+
<h3 id="create-pomxml">Create pom.xml</h3>
-<p>A default <code>pom.xml</code> for building of an <code>WAR-File</code> is created.
+<p>After creation of the project structure the default <code>pom.xml</code> for building of an <code>WAR-File</code> have to be created.
In addition we need the dependency to all necessary <em>Apache Olingo artifacts</em> and to the used <code>JAX-RS</code> implementation which in this sample is <code>Apache CXF</code>.</p>
<p>The resulting <code>pom.xml</code> then looks like:</p>
<div class="codehilite"><pre><span class="cp"><?xml version="1.0" encoding="UTF-8"?></span>
@@ -386,8 +395,14 @@ The next step is to provide the necessar
<h3 id="deploy-and-run">Deploy and Run</h3>
-<p>Build the project with maven via <code>mvm clean package</code> and copy the resulting <code>WAR-File</code> from the projects <code>target</code> folder in the <code>deploy</code> folder of the application server.</p>
-<p>Now just navigate to the URL (e.g. <code>http://localhost:8080/cars-annotations-sample/AnnotationSample.svc</code>).</p>
+<p>Build the project with maven via <code>mvm clean package</code> and copy the resulting <code>WAR-File</code> from the projects <code>target</code> folder in the <code>deploy</code> folder of the web application server (e.g. a <a href="http://tomcat.apache.org/">Tomcat</a>).
+As example for a default Tomcat 7.x installation <code>cp $PROJECT_HOME/target/cars-annotations-sample.war $TOMCAT_HOME/webapps</code>.</p>
+<p>After starting the web application server it is possible to request e.g.
+ * the <em>Service Document</em> via the URL: <code>http://localhost:8080/cars-annotations-sample/AnnotationSample.svc/</code>
+ * the <em>Metadata</em> via the URL: <code>http://localhost:8080/cars-annotations-sample/AnnotationSample.svc/$metadata</code>
+ * the <em>Cars</em> EntitySet via the URL: <code>http://localhost:8080/cars-annotations-sample/AnnotationSample.svc/CarSet</code>
+ * the <em>Manufacturer</em> EntitySet via the URL: <code>http://localhost:8080/cars-annotations-sample/AnnotationSample.svc/ManufacturerSet</code></p>
+<p>Also it is possible to create <em>Car</em> and <em>Manufacturer</em> Entities via <code>HTTP POST</code> requests.</p>
<h2 id="more-detailed-look">More detailed look</h2>
<p>A more detailed look into the Annotation Processor Extension can be found in the <a href="https://wiki.apache.org/Olingo/Documentation/AnnotationProcessor">wiki</a>.</p>