[prev in list] [next in list] [prev in thread] [next in thread] 

List:       ojb-dev
Subject:    cvs commit: db-ojb/forrest/src/documentation/content/xdocs/docu deployment.xml
From:       arminw () apache ! org
Date:       2004-04-24 11:34:53
Message-ID: 20040424113453.87727.qmail () minotaur ! apache ! org
[Download RAW message or body]

arminw      2004/04/24 04:34:53

  Modified:    forrest/src/documentation/content/xdocs/docu deployment.xml
  Log:
  update packin .ear section. Thanks to Stephen Ting
  
  Revision  Changes    Path
  1.2       +78 -13    \
db-ojb/forrest/src/documentation/content/xdocs/docu/deployment.xml  
  Index: deployment.xml
  ===================================================================
  RCS file: /home/cvs/db-ojb/forrest/src/documentation/content/xdocs/docu/deployment.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- deployment.xml	22 Apr 2004 19:29:50 -0000	1.1
  +++ deployment.xml	24 Apr 2004 11:34:53 -0000	1.2
  @@ -23,6 +23,7 @@
           <authors>
               <person name="Thomas Mahler" email="thma@apache.org"/>
               <person name="Armin Waibel" email="arminw@apache.org"/>
  +            <person name="Stephen Ting" email=""/>
               <person name="Christophe Lombart" email=""/>
               <person name="Lucy Zhao" email=""/>
           </authors>
  @@ -744,35 +745,99 @@
                   <title>Packing an .ear file</title>
                   <anchor id="packing-ear"/>
                   <p>
  -                    Here is a sample how a .ear file should be packed with OJB:
  +                    Here is an example of the .ear package structure. It is \
redeployable  +                    without having to restart JBoss.
                   </p>
  -                <source><![CDATA[
  +                <section>
  +                    <title>The Package Structure</title>
  +                    <p>
  +                        The package structure of the <em>.ear</em> file should \
look like:  +                    </p>
  +                    <source><![CDATA[
   /ejb.jar/
   ...EJBs
  -...DAOs
   ...META-INF/
   ......ejb-jar.xml
   ......jboss.xml
  -......MANIFEST.MF [Class-Path: /lib/ojb.jar<CRLF>]   <--- VERY IMPORTANT
  -
  -/lib/
  -...ojb.jar
  +......MANIFEST.MF
   
   /web-app.war/
   ...JSP
   ...WEB-INF/
  -......web.xml [ejb-refs to EJBs]
  +......web.xml
   
   /META-INF/
   ...application.xml
  +/ojb.jar
  +/[ojb required runtime jar]
   
   /OJB.properties
  +/repository.dtd
  +/respository_internal.xml
   /repository.xml
  -/repository_database.xml
  -/repository_user.xml]]></source>
  +/repository_database1.xml
  +/repository_app1.xml
  +/repository_database2.xml
  +/repository_app2.xml]]></source>
  +                    </section>
  +                <section>
  +                    <title>Make OJB API Resources available</title>
  +                    <p>
  +                        There are two approaches to use OJB api in the ejb.jar \
file:  +                    </p>
  +                    <p>
  +                        <strong>1.</strong> To create a Manifest.mf file with \
classpath attribute that include  +                        all the runtime jar \
required by OJB (Very important to include all  +                        required \
jar). The sample below works fine:  +                    </p>
  +                    <source><![CDATA[
  +Class-Path: db-ojb-1.0.rc6.jar antlr-2.7.3.jar commons-beanutils.jar
  +commons-collections.jar commons-dbcp-1.1.jar commons-lang-2.0.jar
  +commons-logging.jar commons-pool-1.1.jar
  +jakarta-regexp-1.3.jar]]></source>
  +                    <note>
  +                        If you to include the jar file under a directory of the \
ear file,  +                        says <code>/lib/db-ojb-1.0.rc6.jar</code> and \
etc. At the classpath  +                        attribute it will be something like:
  +                        <code>Class-Path: ./lib/db-ojb-1.0.rc6.jar and etc</code> \
(The "." in front is  +                        important)
  +                    </note>
  +                    <p>
  +                        <strong>2.</strong> To add the required jar file as a \
"java" element in the  +                        application.xml file:
  +                    </p>
  +                    <source><![CDATA[
  +<module>
  +    <java>antlr-2.7.3.jar</java>
  +</module>
  +<module>
  +    <java>commons-beanutils.jar</java>
  +</module>
  +<module>
  +    <java>commons-collections.jar</java>
  +</module>
  +<module>
  +    <java>commons-dbcp-1.1.jar</java>
  +</module>
  +<module>
  +    <java>commons-lang-2.0.jar</java>
  +</module>
  +<module>
  +    <java>commons-logging.jar</java>
  +</module>
  +<module>
  +    <java>commons-pool-1.1.jar</java>
  +</module>
  +<module>
  +    <java>db-ojb-1.0.rc6.jar</java>
  +</module>]]></source>
  +                    <note>
  +                    To use this approach, all the library had to be in the root of \
the  +                    ear.
  +                    </note>
  +                    </section>
                   <p>
  -                    I'm not sure, but I think in most cases you may need the \
                libraries OJB depends on too in the
  -                    <code>/lib</code> directory to make the .ear file proper \
re-deployable.  +                    (This was tested on Jboss 3.2.3)
                   </p>
               </section>
   
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
For additional commands, e-mail: ojb-dev-help@db.apache.org


[prev in list] [next in list] [prev in thread] [next in thread]