From seam-commits at lists.jboss.org Mon Nov 23 22:47:48 2009
Content-Type: multipart/mixed; boundary="===============5660947117185842129=="
MIME-Version: 1.0
From: seam-commits at lists.jboss.org
To: seam-commits at lists.jboss.org
Subject: [seam-commits] Seam SVN: r11660 -
tags/JBPAPP_4_3_CP07_FP_CR1a/doc/Seam_Reference_Guide/en-US.
Date: Mon, 23 Nov 2009 22:47:48 -0500
Message-ID: <200911240347.nAO3lm3A015182@svn01.web.mwc.hst.phx2.redhat.com>
--===============5660947117185842129==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
Author: laubai
Date: 2009-11-23 22:47:48 -0500 (Mon, 23 Nov 2009)
New Revision: 11660
Modified:
tags/JBPAPP_4_3_CP07_FP_CR1a/doc/Seam_Reference_Guide/en-US/Groovy.xml
tags/JBPAPP_4_3_CP07_FP_CR1a/doc/Seam_Reference_Guide/en-US/Hsearch.xml
tags/JBPAPP_4_3_CP07_FP_CR1a/doc/Seam_Reference_Guide/en-US/I18n.xml
Log:
Edited groovy, hsearch, i18n chapters.
Modified: tags/JBPAPP_4_3_CP07_FP_CR1a/doc/Seam_Reference_Guide/en-US/Groov=
y.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- tags/JBPAPP_4_3_CP07_FP_CR1a/doc/Seam_Reference_Guide/en-US/Groovy.xml =
2009-11-24 03:39:31 UTC (rev 11659)
+++ tags/JBPAPP_4_3_CP07_FP_CR1a/doc/Seam_Reference_Guide/en-US/Groovy.xml =
2009-11-24 03:47:48 UTC (rev 11660)
@@ -5,10 +5,9 @@
Groovy integration
=
One aspect of JBoss Seam is its RAD (Rapid Application Developme=
nt) capability. While not synonymous with RAD,
- one interesting tool in this space is dynamic languages. Until rec=
ently, choosing a dynamic language was
- required choosing a completely different development platform (a d=
evelopment platform with a set of APIs and a
- runtime so great that you would no longer want to use you old lega=
cy Java [sic] APIs anymore, which would be
- lucky because you would be forced to use those proprietary APIs an=
yway). Dynamic languages built on top of the
+ one interesting tool in this space is dynamic languages. Until rec=
ently, choosing a dynamic language =
+ required choosing a completely different development platform with=
a different set of Java APIs.
+ Dynamic languages built on top of the
Java Virtual Machine, and Groovy in particular broke this
approach in silos.
=
@@ -46,8 +45,8 @@
Writing Seam applications in Groovy
=
- There is not much to say about it. Since a Groovy object is =
a Java object, you can virtually write any
- Seam component, or any class for what it worth, in Groovy and =
deploy it. You can also mix Groovy classes and
+ Since a Groovy object is a Java object, you can virtually wr=
ite any
+ Seam component, or any class, in Groovy and deploy it. You can=
also mix Groovy classes and
Java classes in the same application.
=
@@ -94,7 +93,7 @@
}
}
=
- Groovy natively support the notion of properties (ge=
tter/setter), so there is no need to
+ Groovy natively supports the notion of properties (g=
etter/setter), so there is no need to
explicitly write verbose getters and setters: in the p=
revious example, the hotel class can be
accessed from Java as hotel.getCity(), th=
e getters and setters being generated by the
Groovy compiler. This type of syntactic sugar makes th=
e entity code very concise.
@@ -143,7 +142,7 @@
seam-gen
=
- Seam gen has a transparent integration with Groovy. You =
can write Groovy code in seam-gen backed
+ Seam gen itegrates transparently with Groovy. You can wr=
ite Groovy code in seam-gen backed
projects without any additional infrastructure requirement=
. When writing a Groovy entity, simply place
your .groovy files in src/m=
odel. Unsurprisingly, when writing
an action, simply place your .groovy =
files in
@@ -166,10 +165,10 @@
Deploying Groovy code
=
A Groovy class is a Java class, wit=
h a bytecode representation just like a Java
- class. To deploy, a Groovy entity, a Groovy Session bean o=
r a Groovy Seam component, a compilation step
+ class. To deploy a Groovy entity, a Groovy Session bean or=
a Groovy Seam component, a compilation step
is necessary. A common approach is to use the gro=
ovyc ant task. Once compiles, a
Groovy class is in no way different than a Java class and =
the application server will treat them
- equally. Note that this allow a seamless mix of Groovy and=
Java code.
+ equally. Note that this allows a seamless mix of Groovy an=
d Java code.
=
@@ -183,7 +182,7 @@
incrementally with no need to restart the application (and=
obviously not the application server either).
=
Be aware that the native .groovy file deployment suffers=
the same limitations as the regular Seam
- hotdeployment:
+ hot deployment:
=
Modified: tags/JBPAPP_4_3_CP07_FP_CR1a/doc/Seam_Reference_Guide/en-US/Hsear=
ch.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- tags/JBPAPP_4_3_CP07_FP_CR1a/doc/Seam_Reference_Guide/en-US/Hsearch.xml=
2009-11-24 03:39:31 UTC (rev 11659)
+++ tags/JBPAPP_4_3_CP07_FP_CR1a/doc/Seam_Reference_Guide/en-US/Hsearch.xml=
2009-11-24 03:47:48 UTC (rev 11660)
@@ -7,24 +7,23 @@
Introduction
=
- Full text search engines like Apache Lucene=E2=84=A2 are a very pow=
erful
+ Full text search engines like Apache Lucene are a very powerful
technology that bring full text and efficient queries to applications.
Hibernate Search, which uses Apache Lucene under the covers, indexes your
domain model with the addition of a few annotations, takes care of the
database / index synchronization and returns regular managed objects that
- are matched by full text queries. Keep in mind, thought, that there are
+ are matched by full text queries. Keep in mind, though, that there are
mismatches that arise when dealing with an object domain model over a text
index (keeping the index up to date, mismatch between the index structure
and the domain model, and querying mismatch). But the benefits of speed
and efficiency far outweigh these limitations.
=
- Hibernate Search has been designed to integrates nicely and as
+ Hibernate Search has been designed to integrate as
naturally as possible with JPA and Hibernate. As a natural extension,
JBoss Seam provides an Hibernate Search integration.
=
- Please refer to the Hibernate
- Search documentation for information specific to the Hibernate
+ Please refer to the Hibernate Search documentation provided with th=
is release
+ of JBoss Enterprise Application Platform for information specific to t=
he Hibernate
Search project.
=
@@ -60,7 +59,7 @@
]]>
=
If you plan to target Hibernate Annotations or EntityManager 3.2=
.x
- (embedded into JBoss EAP AS 4.3), you also need to configure the
+ (embedded into JBoss Enterprise Application Platform 4.3), you also ne=
ed to configure the
appropriate event listeners.
=
@@ -115,10 +114,8 @@
Usage
=
- Hibernate Search uses annotations to map entities to a Lucene in=
dex,
- check the reference
- documentation for more informations.
+ Hibernate Search uses annotations to map entities to a Lucene in=
dex. For more information,
+ see the Hibernate Reference Guide provided with this release.
=
Hibernate Search is fully integrated with the API and semantic of
JPA / Hibernate. Switching from a HQL or Criteria based query requires
Modified: tags/JBPAPP_4_3_CP07_FP_CR1a/doc/Seam_Reference_Guide/en-US/I18n.=
xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- tags/JBPAPP_4_3_CP07_FP_CR1a/doc/Seam_Reference_Guide/en-US/I18n.xml 20=
09-11-24 03:39:31 UTC (rev 11659)
+++ tags/JBPAPP_4_3_CP07_FP_CR1a/doc/Seam_Reference_Guide/en-US/I18n.xml 20=
09-11-24 03:47:48 UTC (rev 11660)
@@ -7,21 +7,21 @@
Seam makes it easy to build internationalized applications. First, l=
et's =
walk through all the stages needed to internationalize and localize =
your =
- app. Then we'll take a look at the components Seam bundles.
+ application. Then we'll take a look at the component Seam bundles.
=
- Internationalizing your app
+ Internationalizing your application
=
- A JEE application consists of many components and all of them mus=
t be =
+ A Java EE application consists of many components and all of them=
must be =
configured properly for your application to be localized.
=
Starting at the bottom, the first step is to ensure that your dat=
abase =
- server and client is using the correct character encoding for you=
r =
- locale. Normally you'll want to use UTF-8. How to do this is outs=
ide
+ server and client uses the correct character encoding for your =
+ locale. Normally you will want to use UTF-8. How to do this is ou=
tside
the scope of this tutorial.
=
@@ -104,8 +104,8 @@
To set the display character encoding, you need to use the =
<f:view locale=3D"cs_CZ"/> tag (here =
we tell =
JSF to use the Czech locale). You may want to change the encod=
ing of =
- the xml document itself if you want to embed localized strings=
in the
- xml. To do this alter the encoding attribute in xml declaratio=
n =
+ the XML document itself if you want to embed localized strings=
in the
+ XML. To do this alter the encoding attribute in XML declaratio=
n =
<?xml version=3D"1.0" encoding=3D"UTF-8"?> as =
required.
@@ -129,7 +129,7 @@
Each user login session has an associated instance of
java.util.Locale (available to the application as a
component named locale). Under normal circumstances,
- you won't need to do any special configuration to set the locale. Seam
+ you will not need to do any special configuration to set the locale. S=
eam
just delegates to JSF to determine the active locale:
=
@@ -190,7 +190,7 @@
JSF supports internationalization of user interface labels and
descriptive text via the use of <f:loadBundle />.
You can use this approach in Seam applications. Alternatively, you can
- take advantage of the Seam messages component to
+ take advantage of the Seam messages component to
display templated labels with embedded EL expressions.
=
@@ -202,9 +202,7 @@
internationalized labels available via this special resource bundle.=
By
default, the resource bundle used by Seam is named
messages and so you'll need to define your labels=
in
- files named messages.properties,
- messages_en.properties,
- messages_en_AU.properties, etc. These files usually belong=
in
+ files named messages.properties, message=
s_en.properties, messages_en_AU.properties, et=
c. These files usually belong in
the WEB-INF/classes directory.
=
So, in messages_en.properties:
@@ -230,7 +228,7 @@
=
If you want to define a message just for a particular page, you
can specify it in a resource bundle with the same name as the JSF vi=
ew
- id, with the leading / and trailing file extension
+ ID, with the leading / and trailing file extension
removed. So we could put our message in
welcome/hello_en.properties if we only needed to display t=
he
message on /welcome/hello.jsp.
@@ -334,7 +332,9 @@
</theme:available-themes>
</theme:theme-selector>
=
- Note that the first theme listed is the default theme.
+
+ The first theme listed is the default theme.
+
=
Themes are defined in a properties file with the same name as the
theme. For example, the default theme is defined as=
a
--===============5660947117185842129==--