Skip to content

Commit

Permalink
whitespace
Browse files Browse the repository at this point in the history
  • Loading branch information
@pmuir
pmuir committed Sep 24, 2010
1 parent 9da1e23 commit 953724f
Show file tree
Hide file tree
Showing 3 changed files with 65 additions and 68 deletions.
55 changes: 30 additions & 25 deletions docs/src/main/docbook/en-US/annotationliterals.xml
View file
Expand Up @@ -2,39 +2,44 @@
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

<chapter id="annotationliterals">
<title>Annotation Literals</title>
<section>
<title>Annotation Literals</title>
<section>
<title>Summary</title>

<para>
Weld extensions provides a complete set of <literal>AnnotationLiteral</literal>s for every annotation type
defined by the JSR-299 and JSR-330 specification. These are located in the
<literal>org.jboss.weld.extensions.literal</literal> package. Annotations without members provide a static
<literal>INSTANCE</literal> member that should be used rather than creating a new instance every time.
</para>
<para>Literals are provided for the following annotations:</para>

<para>
Literals are provided for the following annotations:
</para>

<simplelist>
<member><literal>@Alternative</literal></member>
<member><literal>@Any</literal></member>
<member><literal>@ApplicationScoped</literal></member>
<member><literal>@ConversationScoped</literal></member>
<member><literal>@Decorator</literal></member>
<member><literal>@Default</literal></member>
<member><literal>@Delegate</literal></member>
<member><literal>@Dependent</literal></member>
<member><literal>@Disposes</literal></member>
<member><literal>@Inject</literal></member>
<member><literal>@Model</literal></member>
<member><literal>@Named</literal></member>
<member><literal>@New</literal></member>
<member><literal>@NonBinding</literal></member>
<member><literal>@NormalScope</literal></member>
<member><literal>@Observes</literal></member>
<member><literal>@Produces</literal></member>
<member><literal>@RequestScoped</literal></member>
<member><literal>@SessionScoped</literal></member>
<member><literal>@Specializes</literal></member>
<member><literal>@Stereotype</literal></member>
<member><literal>@Typed</literal></member>
<member><literal>@Alternative</literal></member>
<member><literal>@Any</literal></member>
<member><literal>@ApplicationScoped</literal></member>
<member><literal>@ConversationScoped</literal></member>
<member><literal>@Decorator</literal></member>
<member><literal>@Default</literal></member>
<member><literal>@Delegate</literal></member>
<member><literal>@Dependent</literal></member>
<member><literal>@Disposes</literal></member>
<member><literal>@Inject</literal></member>
<member><literal>@Model</literal></member>
<member><literal>@Named</literal></member>
<member><literal>@New</literal></member>
<member><literal>@NonBinding</literal></member>
<member><literal>@NormalScope</literal></member>
<member><literal>@Observes</literal></member>
<member><literal>@Produces</literal></member>
<member><literal>@RequestScoped</literal></member>
<member><literal>@SessionScoped</literal></member>
<member><literal>@Specializes</literal></member>
<member><literal>@Stereotype</literal></member>
<member><literal>@Typed</literal></member>
</simplelist>
</section>
</chapter>
41 changes: 16 additions & 25 deletions docs/src/main/docbook/en-US/annotationutilities.xml
View file
Expand Up @@ -2,22 +2,22 @@
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

<chapter id="annotationutilities">
<title>Annotation Utilities</title>
<title>Annotation Utilities</title>

<section>
<title>Annotated Type Builder</title>
<para>Weld extensions provides an <literal>AnnotatedType</literal> implementation that should be suitable for most
portable extensions needs. The <literal>AnnotatedType</literal> is created from <literal>AnnotatedTypeBuilder</literal>
as follows:
</para>
<programlisting role="java" >
AnnotatedTypeBuilder builder = new AnnotatedTypeBuilder();
<section>
<title>Annotated Type Builder</title>
<para>
Weld extensions provides an <literal>AnnotatedType</literal> implementation that should be suitable for most
portable extensions needs. The <literal>AnnotatedType</literal> is created from
<literal>AnnotatedTypeBuilder</literal> as follows:
</para>
<programlisting role="JAVA" ><![CDATA[AnnotatedTypeBuilder builder = new AnnotatedTypeBuilder();
//readFromType can read from an AnnotatedType or a class
builder.readFromType(baseType,true);
//add the @Model annotation
builder.addToClass(ModelLiteral.INSTANCE);
AnnotatedType type = builder.create();
</programlisting>
AnnotatedType type = builder.create();]]></programlisting>
<para>
For more information see the API docs.
</para>
Expand All @@ -30,11 +30,8 @@ AnnotatedType type = builder.create();
<literal>AnnotationLiteral</literal> instance for any annotation at runtime. Annotation members
are passed in via a <literal>Map&lt;String,Object&gt;</literal>. For example given the follow annotation:
</para>
<programlisting role="java">
<![CDATA[
@Retention(RetentionPolicy.RUNTIME)
public @interface MultipleMembers
{
<programlisting role="JAVA"><![CDATA[@Retention(RetentionPolicy.RUNTIME)
public @interface MultipleMembers {
int intMember();
long longMember();
Expand All @@ -52,15 +49,11 @@ public @interface MultipleMembers
boolean booleanMember();
int[] intArrayMember();
}
]]>
</programlisting>
}]]></programlisting>
<para>
We can create an <literal>AnnotationLiteral</literal> instance as follows:
</para>
<programlisting role="java">
<![CDATA[
AnnotationInstanceProvider provider = new AnnotationInstanceProvider();
<programlisting role="java"><![CDATA[AnnotationInstanceProvider provider = new AnnotationInstanceProvider();
Map<String, Object> values = new HashMap<String, Object>();
values.put("intMember", 1);
values.put("longMember", 1);
Expand All @@ -71,9 +64,7 @@ values.put("byteMember", ((byte) 1));
values.put("charMember", 'c');
values.put("booleanMember", true);
values.put("intArrayMember", new int[] { 0, 1 });
MultipleMembers an = provider.get(MultipleMembers.class, values);
]]>
</programlisting>
MultipleMembers an = provider.get(MultipleMembers.class, values);]]></programlisting>
</section>

</chapter>
37 changes: 19 additions & 18 deletions docs/src/main/docbook/en-US/master.xml
View file
Expand Up @@ -3,25 +3,26 @@
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ ]>
<book lang="en">

<title>Weld Extensions</title>
<title>Weld Extensions</title>

<preface>
<title>Introduction</title>
Weld Extensions is a library of Generally Useful Stuff (tm), particularly if you are
developing an application based on CDI (JSR-299 Java Contexts and Dependency Injection),
or a CDI portable extension.
</preface>
<preface>
<title>Introduction</title>
Weld Extensions is a library of Generally Useful Stuff (tm), particularly if you are
developing an application based on CDI (JSR-299 Java Contexts and Dependency Injection),
or a CDI portable extension.
</preface>

<xi:include href="annotationutilities.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="beanutilities.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="propertyquery.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="annotationliterals.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="elextensions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="resourceloading.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="managedproducer.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="logging.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="defaultbeans.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="servicehandler.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="annotationutilities.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="beanutilities.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="propertyquery.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="annotationliterals.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="elextensions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="resourceloading.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="managedproducer.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="logging.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="defaultbeans.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="servicehandler.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />

<toc/>
<toc/>

</book>

0 comments on commit 953724f

Please sign in to comment.