[jboss-cvs] JBossAS SVN: r65908 - in projects/microcontainer/trunk/docs: Getting_Started_Guide and 1 other directories.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Mon Oct 8 08:01:33 EDT 2007
Author: newtonm
Date: 2007-10-08 08:01:33 -0400 (Mon, 08 Oct 2007)
New Revision: 65908
Added:
projects/microcontainer/trunk/docs/Getting_Started_Guide/
projects/microcontainer/trunk/docs/Getting_Started_Guide/en-US/
projects/microcontainer/trunk/docs/Getting_Started_Guide/en-US/Author_Group.xml
projects/microcontainer/trunk/docs/Getting_Started_Guide/en-US/Getting_Started.xml
projects/microcontainer/trunk/docs/Getting_Started_Guide/en-US/Legal_Notice.xml
projects/microcontainer/trunk/docs/Getting_Started_Guide/en-US/images/
projects/microcontainer/trunk/docs/Getting_Started_Guide/pom.xml
Log:
Added new Getting Started Guide.
Added: projects/microcontainer/trunk/docs/Getting_Started_Guide/en-US/Author_Group.xml
===================================================================
--- projects/microcontainer/trunk/docs/Getting_Started_Guide/en-US/Author_Group.xml (rev 0)
+++ projects/microcontainer/trunk/docs/Getting_Started_Guide/en-US/Author_Group.xml 2007-10-08 12:01:33 UTC (rev 65908)
@@ -0,0 +1,6 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+<authorgroup>
+ <corpauthor>Mark Newton</corpauthor>
+</authorgroup>
Added: projects/microcontainer/trunk/docs/Getting_Started_Guide/en-US/Getting_Started.xml
===================================================================
--- projects/microcontainer/trunk/docs/Getting_Started_Guide/en-US/Getting_Started.xml (rev 0)
+++ projects/microcontainer/trunk/docs/Getting_Started_Guide/en-US/Getting_Started.xml 2007-10-08 12:01:33 UTC (rev 65908)
@@ -0,0 +1,39 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+<!ENTITY % RH-ENTITIES SYSTEM "Common_Config/rh-entities.ent">
+]>
+<book>
+ <bookinfo>
+ <title>JBoss Microcontainer 2.0.0</title>
+ <subtitle>Getting Started Guide</subtitle>
+ <issuenum>2.0</issuenum>
+ <productnumber>2</productnumber>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Author_Group.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Legal_Notice.xml"/>
+ </bookinfo>
+ <preface>
+ <title>What this Book Covers</title>
+ <para>This book aims to help you become familiar with JBoss Microconainer if you are new to the technology.</para>
+ </preface>
+ <chapter id="overview">
+ <title>Overview</title>
+ <para>The Java platform has traditionally been distributed in 3 editions, each providing a different kind of runtime environment: </para>
+ <itemizedlist>
+ <listitem>
+ <para>Java ME - Mobile or other small-scale devices</para>
+ </listitem>
+ <listitem>
+ <para>Java SE - Desktop machines or servers (typically running 2-tier applications)</para>
+ </listitem>
+ <listitem>
+ <para>Java EE - Servers (typically running 3-tier applications)</para>
+ </listitem>
+ </itemizedlist>
+ <para>Each environment aims to provide a base level of functionality on top of which developers can add their own code to create applications. For example Java SE provides networking and security libraries together with graphical user interface toolkits to facilitate the development of desktop and simple client-server applications. Java EE takes this a stage further by adding a number of 'enterprise' services such as transactions, messaging and persistence that allow much more robust and scalable 'enterprise' applications to be developed. These services are typically combined together inside a JEE application server to provide a standard runtime environment for enterprise applications but there are frequent occasions when some are not used.</para>
+ <para>Having unused services in your environment is undesirable as they often take up valuable resources such as CPU and memory. They can also clutter up the environment with unecessary configuration files which complicates maintenance and causes confusion. It would therefore be good if there was a controlled way to remove them without breaking any dependencies they might have. Similarly there are often occasions when applications need services that aren't provided by JEE so it would be good if there was a controlled way to add them, again making sure that any dependencies are first satisfied.</para>
+ <para>JBoss Microcontainer aims to provide these capabilities by allowing services, created using Plain Old Java Objects (POJOs), to be deployed into a standard Java SE runtime environment in a controlled manner to create a customized environment for your applications. Dependencies between services are fully managed by the microcontainer to ensure that new services cannot be deployed until services they depend on have been deployed. Likewise undeploying a service causes all dependent services to first be undeployed to maintain the integrity of the system. </para>
+ <para>As JBoss Microcontainer is very lightweight and deals with POJOs it can also be used to deploy services into a Java ME runtime environment. This opens us new possibilities for mobile applications that can now take advantage of enterprise services without requiring a full JEE application server. </para>
+ <para>It can even be used to deploy services inside other (non-JBoss) Java EE runtime environments such as WebLogic, Tomcat or Glassfish thanks to it pluggable classloading features. </para>
+ <para>Finally JBoss Microcontainer can be used to create services using dependency injection to wire individual POJOs together. Configuration is performed using either XML or annotations depending on where the information is best located. In common with other dependency injection frameworks JBoss Microcontainer can easily be used to create unit tests for POJOs within a service and can also facilitate integration testing of services that depend on each other. </para>
+ </chapter>
+</book>
Added: projects/microcontainer/trunk/docs/Getting_Started_Guide/en-US/Legal_Notice.xml
===================================================================
--- projects/microcontainer/trunk/docs/Getting_Started_Guide/en-US/Legal_Notice.xml (rev 0)
+++ projects/microcontainer/trunk/docs/Getting_Started_Guide/en-US/Legal_Notice.xml 2007-10-08 12:01:33 UTC (rev 65908)
@@ -0,0 +1,17 @@
+<?xml version='1.0'?>
+<!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+
+<legalnotice id="Book-Legal_Notice">
+ <title>Legal Notice</title>
+ <para>
+ <address>
+ <street>1801 Varsity Drive</street>
+ <city>Raleigh</city>, <state>NC</state><postcode>27606-2072</postcode><country>USA</country><phone>Phone: +1 919 754 3700</phone>
+ <phone>Phone: 888 733 4281</phone>
+ <fax>Fax: +1 919 754 3701</fax>
+ <pob>PO Box 13588</pob><city>Research Triangle Park</city>, <state>NC</state><postcode>27709</postcode><country>USA</country>
+ </address>
+ </para>
+</legalnotice>
+
Added: projects/microcontainer/trunk/docs/Getting_Started_Guide/pom.xml
===================================================================
--- projects/microcontainer/trunk/docs/Getting_Started_Guide/pom.xml (rev 0)
+++ projects/microcontainer/trunk/docs/Getting_Started_Guide/pom.xml 2007-10-08 12:01:33 UTC (rev 65908)
@@ -0,0 +1,84 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+ <modelVersion>4.0.0</modelVersion>
+
+ <groupId>org.jboss.microcontainer</groupId>
+ <artifactId>microcontainer-getting-started-guide-${translation}</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ <packaging>jdocbook</packaging>
+ <name>Getting Started Guide (${translation})</name>
+
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.jboss.maven.plugins</groupId>
+ <artifactId>maven-jdocbook-plugin</artifactId>
+ <version>2.0.0</version>
+ <extensions>true</extensions>
+ <!--dependencies>
+ <dependency>
+ <groupId>org.hibernate</groupId>
+ <artifactId>hibernate-docbook-xslt</artifactId>
+ <type>jdocbook-style</type>
+ <version>0.1</version>
+ </dependency>
+ </dependencies-->
+ <configuration>
+ <sourceDocumentName>Getting_Started.xml</sourceDocumentName>
+ <imageResource>
+ <directory>en-US</directory>
+ <excludes>
+ <exclude>*.xml</exclude>
+ </excludes>
+ </imageResource>
+ <cssResource>
+ <directory>en-US</directory>
+ <excludes>
+ <exclude>*.xml</exclude>
+ </excludes>
+ </cssResource>
+ <formats>
+ <format>
+ <formatName>pdf</formatName>
+ <!--stylesheetResource>classpath:/standard/fopdf.xsl</stylesheetResource-->
+ <finalName>Getting_Started_Guide.pdf</finalName>
+ </format>
+ <format>
+ <formatName>html</formatName>
+ <!--stylesheetResource>classpath:/standard/html_chunk.xsl</stylesheetResource-->
+ <finalName>index.html</finalName>
+ </format>
+<!--
+ <format>
+ <formatName>html_single</formatName>
+ <stylesheetResource>classpath:/xslt/nochunk-html.xsl</stylesheetResource>
+ </format>
+-->
+<!-- <format>
+ <formatName>eclipse</formatName>
+ <stylesheetResource>classpath:/xslt/main-eclipse.xsl</stylesheetResource>
+ <finalName>index.html</finalName>
+ </format>
+-->
+ </formats>
+ <options>
+ <xincludeSupported>true</xincludeSupported>
+ <xmlTransformerType>saxon</xmlTransformerType>
+ <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme -->
+ <!-- could also locate the docbook dependency and inspect its version... -->
+ <docbookVersion>1.72.0</docbookVersion>
+ </options>
+
+ <sourceDirectory>${basedir}/en-US</sourceDirectory>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+
+ <properties>
+ <translation>en-US</translation>
+ </properties>
+
+</project>
More information about the jboss-cvs-commits
mailing list