Merge branch 'upstream-master' into HEAD
Initial downstream of atinject code (revision 86)
from https://atinject.googlecode.com/svn/trunk/
Bug: 27552463
Change-Id: Ia72763ed396d2f3ac3bc2bc66fb3e383818e1c82
diff --git a/atinject.iml b/atinject.iml
new file mode 100644
index 0000000..c053808
--- /dev/null
+++ b/atinject.iml
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module relativePaths="true" type="JAVA_MODULE" version="4">
+ <component name="NewModuleRootManager" inherit-compiler-output="true">
+ <exclude-output />
+ <content url="file://$MODULE_DIR$">
+ <sourceFolder url="file://$MODULE_DIR$/src" isTestSource="false" />
+ </content>
+ <orderEntry type="inheritedJdk" />
+ <orderEntry type="sourceFolder" forTests="false" />
+ </component>
+</module>
+
diff --git a/atinject.ipr b/atinject.ipr
new file mode 100644
index 0000000..c06fe67
--- /dev/null
+++ b/atinject.ipr
@@ -0,0 +1,274 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project relativePaths="false" version="4">
+ <component name="AntConfiguration">
+ <defaultAnt bundledAnt="true" />
+ </component>
+ <component name="BuildJarProjectSettings">
+ <option name="BUILD_JARS_ON_MAKE" value="false" />
+ </component>
+ <component name="CodeStyleSettingsManager">
+ <option name="PER_PROJECT_SETTINGS" />
+ <option name="USE_PER_PROJECT_SETTINGS" value="false" />
+ </component>
+ <component name="CompilerConfiguration">
+ <option name="DEFAULT_COMPILER" value="Javac" />
+ <option name="DEPLOY_AFTER_MAKE" value="0" />
+ <resourceExtensions>
+ <entry name=".+\.(properties|xml|html|dtd|tld)" />
+ <entry name=".+\.(gif|png|jpeg|jpg)" />
+ </resourceExtensions>
+ <wildcardResourcePatterns>
+ <entry name="?*.properties" />
+ <entry name="?*.xml" />
+ <entry name="?*.gif" />
+ <entry name="?*.png" />
+ <entry name="?*.jpeg" />
+ <entry name="?*.jpg" />
+ <entry name="?*.html" />
+ <entry name="?*.dtd" />
+ <entry name="?*.tld" />
+ <entry name="?*.ftl" />
+ </wildcardResourcePatterns>
+ </component>
+ <component name="CopyrightManager" default="">
+ <module2copyright />
+ </component>
+ <component name="DependencyValidationManager">
+ <option name="SKIP_IMPORT_STATEMENTS" value="false" />
+ </component>
+ <component name="EclipseCompilerSettings">
+ <option name="DEBUGGING_INFO" value="true" />
+ <option name="GENERATE_NO_WARNINGS" value="true" />
+ <option name="DEPRECATION" value="false" />
+ <option name="ADDITIONAL_OPTIONS_STRING" value="" />
+ <option name="MAXIMUM_HEAP_SIZE" value="128" />
+ </component>
+ <component name="Encoding" useUTFGuessing="true" native2AsciiForPropertiesFiles="false" />
+ <component name="EntryPointsManager">
+ <entry_points version="2.0" />
+ </component>
+ <component name="IdProvider" IDEtalkID="293ECBF8C3B5C62E10353C1DB8516323" />
+ <component name="InspectionProjectProfileManager">
+ <option name="PROJECT_PROFILE" value="Project Default" />
+ <option name="USE_PROJECT_PROFILE" value="true" />
+ <version value="1.0" />
+ <profiles>
+ <profile version="1.0" is_locked="false">
+ <option name="myName" value="Project Default" />
+ <option name="myLocal" value="false" />
+ </profile>
+ </profiles>
+ <list size="5">
+ <item index="0" class="java.lang.String" itemvalue="TYPO" />
+ <item index="1" class="java.lang.String" itemvalue="WARNING" />
+ <item index="2" class="java.lang.String" itemvalue="SERVER PROBLEM" />
+ <item index="3" class="java.lang.String" itemvalue="INFO" />
+ <item index="4" class="java.lang.String" itemvalue="ERROR" />
+ </list>
+ </component>
+ <component name="JavacSettings">
+ <option name="DEBUGGING_INFO" value="true" />
+ <option name="GENERATE_NO_WARNINGS" value="false" />
+ <option name="DEPRECATION" value="true" />
+ <option name="ADDITIONAL_OPTIONS_STRING" value="" />
+ <option name="MAXIMUM_HEAP_SIZE" value="128" />
+ </component>
+ <component name="JavadocGenerationManager">
+ <option name="OUTPUT_DIRECTORY" value="$PROJECT_DIR$/javadoc" />
+ <option name="OPTION_SCOPE" value="protected" />
+ <option name="OPTION_HIERARCHY" value="true" />
+ <option name="OPTION_NAVIGATOR" value="true" />
+ <option name="OPTION_INDEX" value="true" />
+ <option name="OPTION_SEPARATE_INDEX" value="true" />
+ <option name="OPTION_DOCUMENT_TAG_USE" value="false" />
+ <option name="OPTION_DOCUMENT_TAG_AUTHOR" value="false" />
+ <option name="OPTION_DOCUMENT_TAG_VERSION" value="false" />
+ <option name="OPTION_DOCUMENT_TAG_DEPRECATED" value="true" />
+ <option name="OPTION_DEPRECATED_LIST" value="true" />
+ <option name="OTHER_OPTIONS" value="-header "<font color='red'><b>This is a DRAFT specification.</b></font>" -bottom "<font size='-1'>Copyright (C) 2009 The JSR-330 Expert Group. Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache License</a>, Version 2.0.</font>"" />
+ <option name="HEAP_SIZE" />
+ <option name="LOCALE" />
+ <option name="OPEN_IN_BROWSER" value="true" />
+ </component>
+ <component name="JikesSettings">
+ <option name="JIKES_PATH" value="" />
+ <option name="DEBUGGING_INFO" value="true" />
+ <option name="DEPRECATION" value="true" />
+ <option name="GENERATE_NO_WARNINGS" value="false" />
+ <option name="IS_EMACS_ERRORS_MODE" value="true" />
+ <option name="ADDITIONAL_OPTIONS_STRING" value="" />
+ </component>
+ <component name="Palette2">
+ <group name="Swing">
+ <item class="com.intellij.uiDesigner.HSpacer" tooltip-text="Horizontal Spacer" icon="/com/intellij/uiDesigner/icons/hspacer.png" removable="false" auto-create-binding="false" can-attach-label="false">
+ <default-constraints vsize-policy="1" hsize-policy="6" anchor="0" fill="1" />
+ </item>
+ <item class="com.intellij.uiDesigner.VSpacer" tooltip-text="Vertical Spacer" icon="/com/intellij/uiDesigner/icons/vspacer.png" removable="false" auto-create-binding="false" can-attach-label="false">
+ <default-constraints vsize-policy="6" hsize-policy="1" anchor="0" fill="2" />
+ </item>
+ <item class="javax.swing.JPanel" icon="/com/intellij/uiDesigner/icons/panel.png" removable="false" auto-create-binding="false" can-attach-label="false">
+ <default-constraints vsize-policy="3" hsize-policy="3" anchor="0" fill="3" />
+ </item>
+ <item class="javax.swing.JScrollPane" icon="/com/intellij/uiDesigner/icons/scrollPane.png" removable="false" auto-create-binding="false" can-attach-label="true">
+ <default-constraints vsize-policy="7" hsize-policy="7" anchor="0" fill="3" />
+ </item>
+ <item class="javax.swing.JButton" icon="/com/intellij/uiDesigner/icons/button.png" removable="false" auto-create-binding="true" can-attach-label="false">
+ <default-constraints vsize-policy="0" hsize-policy="3" anchor="0" fill="1" />
+ <initial-values>
+ <property name="text" value="Button" />
+ </initial-values>
+ </item>
+ <item class="javax.swing.JRadioButton" icon="/com/intellij/uiDesigner/icons/radioButton.png" removable="false" auto-create-binding="true" can-attach-label="false">
+ <default-constraints vsize-policy="0" hsize-policy="3" anchor="8" fill="0" />
+ <initial-values>
+ <property name="text" value="RadioButton" />
+ </initial-values>
+ </item>
+ <item class="javax.swing.JCheckBox" icon="/com/intellij/uiDesigner/icons/checkBox.png" removable="false" auto-create-binding="true" can-attach-label="false">
+ <default-constraints vsize-policy="0" hsize-policy="3" anchor="8" fill="0" />
+ <initial-values>
+ <property name="text" value="CheckBox" />
+ </initial-values>
+ </item>
+ <item class="javax.swing.JLabel" icon="/com/intellij/uiDesigner/icons/label.png" removable="false" auto-create-binding="false" can-attach-label="false">
+ <default-constraints vsize-policy="0" hsize-policy="0" anchor="8" fill="0" />
+ <initial-values>
+ <property name="text" value="Label" />
+ </initial-values>
+ </item>
+ <item class="javax.swing.JTextField" icon="/com/intellij/uiDesigner/icons/textField.png" removable="false" auto-create-binding="true" can-attach-label="true">
+ <default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1">
+ <preferred-size width="150" height="-1" />
+ </default-constraints>
+ </item>
+ <item class="javax.swing.JPasswordField" icon="/com/intellij/uiDesigner/icons/passwordField.png" removable="false" auto-create-binding="true" can-attach-label="true">
+ <default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1">
+ <preferred-size width="150" height="-1" />
+ </default-constraints>
+ </item>
+ <item class="javax.swing.JFormattedTextField" icon="/com/intellij/uiDesigner/icons/formattedTextField.png" removable="false" auto-create-binding="true" can-attach-label="true">
+ <default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1">
+ <preferred-size width="150" height="-1" />
+ </default-constraints>
+ </item>
+ <item class="javax.swing.JTextArea" icon="/com/intellij/uiDesigner/icons/textArea.png" removable="false" auto-create-binding="true" can-attach-label="true">
+ <default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
+ <preferred-size width="150" height="50" />
+ </default-constraints>
+ </item>
+ <item class="javax.swing.JTextPane" icon="/com/intellij/uiDesigner/icons/textPane.png" removable="false" auto-create-binding="true" can-attach-label="true">
+ <default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
+ <preferred-size width="150" height="50" />
+ </default-constraints>
+ </item>
+ <item class="javax.swing.JEditorPane" icon="/com/intellij/uiDesigner/icons/editorPane.png" removable="false" auto-create-binding="true" can-attach-label="true">
+ <default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
+ <preferred-size width="150" height="50" />
+ </default-constraints>
+ </item>
+ <item class="javax.swing.JComboBox" icon="/com/intellij/uiDesigner/icons/comboBox.png" removable="false" auto-create-binding="true" can-attach-label="true">
+ <default-constraints vsize-policy="0" hsize-policy="2" anchor="8" fill="1" />
+ </item>
+ <item class="javax.swing.JTable" icon="/com/intellij/uiDesigner/icons/table.png" removable="false" auto-create-binding="true" can-attach-label="false">
+ <default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
+ <preferred-size width="150" height="50" />
+ </default-constraints>
+ </item>
+ <item class="javax.swing.JList" icon="/com/intellij/uiDesigner/icons/list.png" removable="false" auto-create-binding="true" can-attach-label="false">
+ <default-constraints vsize-policy="6" hsize-policy="2" anchor="0" fill="3">
+ <preferred-size width="150" height="50" />
+ </default-constraints>
+ </item>
+ <item class="javax.swing.JTree" icon="/com/intellij/uiDesigner/icons/tree.png" removable="false" auto-create-binding="true" can-attach-label="false">
+ <default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3">
+ <preferred-size width="150" height="50" />
+ </default-constraints>
+ </item>
+ <item class="javax.swing.JTabbedPane" icon="/com/intellij/uiDesigner/icons/tabbedPane.png" removable="false" auto-create-binding="true" can-attach-label="false">
+ <default-constraints vsize-policy="3" hsize-policy="3" anchor="0" fill="3">
+ <preferred-size width="200" height="200" />
+ </default-constraints>
+ </item>
+ <item class="javax.swing.JSplitPane" icon="/com/intellij/uiDesigner/icons/splitPane.png" removable="false" auto-create-binding="false" can-attach-label="false">
+ <default-constraints vsize-policy="3" hsize-policy="3" anchor="0" fill="3">
+ <preferred-size width="200" height="200" />
+ </default-constraints>
+ </item>
+ <item class="javax.swing.JSpinner" icon="/com/intellij/uiDesigner/icons/spinner.png" removable="false" auto-create-binding="true" can-attach-label="true">
+ <default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1" />
+ </item>
+ <item class="javax.swing.JSlider" icon="/com/intellij/uiDesigner/icons/slider.png" removable="false" auto-create-binding="true" can-attach-label="false">
+ <default-constraints vsize-policy="0" hsize-policy="6" anchor="8" fill="1" />
+ </item>
+ <item class="javax.swing.JSeparator" icon="/com/intellij/uiDesigner/icons/separator.png" removable="false" auto-create-binding="false" can-attach-label="false">
+ <default-constraints vsize-policy="6" hsize-policy="6" anchor="0" fill="3" />
+ </item>
+ <item class="javax.swing.JProgressBar" icon="/com/intellij/uiDesigner/icons/progressbar.png" removable="false" auto-create-binding="true" can-attach-label="false">
+ <default-constraints vsize-policy="0" hsize-policy="6" anchor="0" fill="1" />
+ </item>
+ <item class="javax.swing.JToolBar" icon="/com/intellij/uiDesigner/icons/toolbar.png" removable="false" auto-create-binding="false" can-attach-label="false">
+ <default-constraints vsize-policy="0" hsize-policy="6" anchor="0" fill="1">
+ <preferred-size width="-1" height="20" />
+ </default-constraints>
+ </item>
+ <item class="javax.swing.JToolBar$Separator" icon="/com/intellij/uiDesigner/icons/toolbarSeparator.png" removable="false" auto-create-binding="false" can-attach-label="false">
+ <default-constraints vsize-policy="0" hsize-policy="0" anchor="0" fill="1" />
+ </item>
+ <item class="javax.swing.JScrollBar" icon="/com/intellij/uiDesigner/icons/scrollbar.png" removable="false" auto-create-binding="true" can-attach-label="false">
+ <default-constraints vsize-policy="6" hsize-policy="0" anchor="0" fill="2" />
+ </item>
+ </group>
+ </component>
+ <component name="ProjectDetails">
+ <option name="projectName" value="atinject" />
+ </component>
+ <component name="ProjectDictionaryState">
+ <dictionary name="crazybob" />
+ </component>
+ <component name="ProjectKey">
+ <option name="state" value="https://atinject.googlecode.com/svn/trunk/atinject.ipr" />
+ </component>
+ <component name="ProjectModuleManager">
+ <modules>
+ <module fileurl="file://$PROJECT_DIR$/atinject.iml" filepath="$PROJECT_DIR$/atinject.iml" />
+ <module fileurl="file://$PROJECT_DIR$/tck/tck.iml" filepath="$PROJECT_DIR$/tck/tck.iml" />
+ </modules>
+ </component>
+ <component name="ProjectRootManager" version="2" languageLevel="JDK_1_5" assert-keyword="true" jdk-15="true" project-jdk-name="1.5" project-jdk-type="JavaSDK">
+ <output url="file://$PROJECT_DIR$/out" />
+ </component>
+ <component name="ResourceManagerContainer">
+ <option name="myResourceBundles">
+ <value>
+ <list size="0" />
+ </value>
+ </option>
+ </component>
+ <component name="RmicSettings">
+ <option name="IS_EANABLED" value="false" />
+ <option name="DEBUGGING_INFO" value="true" />
+ <option name="GENERATE_NO_WARNINGS" value="false" />
+ <option name="GENERATE_IIOP_STUBS" value="false" />
+ <option name="ADDITIONAL_OPTIONS_STRING" value="" />
+ </component>
+ <component name="SvnBranchConfigurationManager">
+ <option name="myVersion" value="124" />
+ <option name="mySupportsUserInfoFilter" value="true" />
+ </component>
+ <component name="VcsDirectoryMappings">
+ <mapping directory="" vcs="svn" />
+ </component>
+ <component name="libraryTable">
+ <library name="Guice">
+ <CLASSES>
+ <root url="jar:///Users/jessewilson/Guice/google-guice/lib/aopalliance.jar!/" />
+ <root url="jar:///Users/jessewilson/Guice/google-guice/build/dist/guice-snapshot.jar!/" />
+ </CLASSES>
+ <JAVADOC />
+ <SOURCES>
+ <root url="file:///Users/jessewilson/Guice/google-guice/src" />
+ </SOURCES>
+ </library>
+ </component>
+</project>
+
diff --git a/build.sh b/build.sh
new file mode 100755
index 0000000..33fb95e
--- /dev/null
+++ b/build.sh
@@ -0,0 +1,59 @@
+NAME=javax.inject
+VERSION=SNAPSHOT
+
+# Clear and recreate build directory.
+rm -r build
+mkdir -p build/classes
+mkdir -p build/tck
+mkdir -p build/dist
+mkdir -p build/tck/classes
+mkdir -p build/tck/dist
+
+# Compile classes.
+javac -g -d build/classes `find src -name *.java`
+javac -g -classpath build/classes:lib/junit.jar -d build/tck/classes \
+ `find tck -name *.java`
+
+FOOTER="<font size='-1'>Copyright (C) 2009 <a href='http://code.google.com/p/atinject/'>\
+The JSR-330 Expert Group</a>. \
+Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache \
+License</a>, Version 2.0.</font>"
+
+# Generate Javadocs.
+javadoc -protected -bottom "$FOOTER" \
+ -header "<font color='red'><b>This is a DRAFT specification.</b></font>" \
+ -sourcepath src -d build/javadoc javax.inject
+javadoc -classpath build/classes:lib/junit.jar -protected -bottom "$FOOTER" \
+ -sourcepath tck -d build/tck/javadoc org.atinject.tck \
+ org.atinject.tck.auto org.atinject.tck.auto.accessories
+
+# Generate jars.
+cp -R src build
+cp -R tck build/tck/src
+
+rmSvn() {
+ find $1 -name .svn -type d | xargs rm -r
+}
+
+rmSvn build/src
+rmSvn build/tck/src
+rm build/tck/src/tck.iml
+
+jar cfM build/dist/$NAME-src.zip -C build/src .
+jar cfM build/tck/dist/$NAME-tck-src.zip -C build/tck/src .
+
+jar cfM build/dist/$NAME-javadoc.zip -C build/javadoc .
+jar cfM build/tck/dist/$NAME-tck-javadoc.zip -C build/tck/javadoc .
+jar cfM build/dist/$NAME.jar -C build/classes .
+jar cfM build/tck/dist/$NAME-tck.jar -C build/tck/classes .
+
+jar cfM build/$NAME.zip -C build/dist .
+jar cfM build/$NAME-tck.zip -C build/tck/dist .
+
+# Build Maven bundle.
+mkdir build/maven
+cp build/dist/$NAME.jar build/maven/$NAME-$VERSION.jar
+cp build/dist/$NAME-src.zip build/maven/$NAME-$VERSION-sources.jar
+cp build/dist/$NAME-javadoc.zip build/maven/$NAME-$VERSION-javadoc.jar
+cp pom.xml build/maven
+jar cfM build/$NAME-$VERSION-bundle.jar -C build/maven .
diff --git a/javadoc/allclasses-frame.html b/javadoc/allclasses-frame.html
new file mode 100644
index 0000000..4ca289e
--- /dev/null
+++ b/javadoc/allclasses-frame.html
@@ -0,0 +1,40 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:20 PDT 2009 -->
+<TITLE>
+All Classes
+</TITLE>
+
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
+
+
+</HEAD>
+
+<BODY BGCOLOR="white">
+<FONT size="+1" CLASS="FrameHeadingFont">
+<B>All Classes</B></FONT>
+<BR>
+
+<TABLE BORDER="0" WIDTH="100%" SUMMARY="">
+<TR>
+<TD NOWRAP><FONT CLASS="FrameItemFont"><A HREF="javax/inject/Inject.html" title="annotation in javax.inject" target="classFrame">Inject</A>
+<BR>
+<A HREF="javax/inject/Named.html" title="annotation in javax.inject" target="classFrame">Named</A>
+<BR>
+<A HREF="javax/inject/Provider.html" title="interface in javax.inject" target="classFrame"><I>Provider</I></A>
+<BR>
+<A HREF="javax/inject/Qualifier.html" title="annotation in javax.inject" target="classFrame">Qualifier</A>
+<BR>
+<A HREF="javax/inject/Scope.html" title="annotation in javax.inject" target="classFrame">Scope</A>
+<BR>
+<A HREF="javax/inject/Singleton.html" title="annotation in javax.inject" target="classFrame">Singleton</A>
+<BR>
+</FONT></TD>
+</TR>
+</TABLE>
+
+</BODY>
+</HTML>
diff --git a/javadoc/allclasses-noframe.html b/javadoc/allclasses-noframe.html
new file mode 100644
index 0000000..fd88343
--- /dev/null
+++ b/javadoc/allclasses-noframe.html
@@ -0,0 +1,40 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:20 PDT 2009 -->
+<TITLE>
+All Classes
+</TITLE>
+
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
+
+
+</HEAD>
+
+<BODY BGCOLOR="white">
+<FONT size="+1" CLASS="FrameHeadingFont">
+<B>All Classes</B></FONT>
+<BR>
+
+<TABLE BORDER="0" WIDTH="100%" SUMMARY="">
+<TR>
+<TD NOWRAP><FONT CLASS="FrameItemFont"><A HREF="javax/inject/Inject.html" title="annotation in javax.inject">Inject</A>
+<BR>
+<A HREF="javax/inject/Named.html" title="annotation in javax.inject">Named</A>
+<BR>
+<A HREF="javax/inject/Provider.html" title="interface in javax.inject"><I>Provider</I></A>
+<BR>
+<A HREF="javax/inject/Qualifier.html" title="annotation in javax.inject">Qualifier</A>
+<BR>
+<A HREF="javax/inject/Scope.html" title="annotation in javax.inject">Scope</A>
+<BR>
+<A HREF="javax/inject/Singleton.html" title="annotation in javax.inject">Singleton</A>
+<BR>
+</FONT></TD>
+</TR>
+</TABLE>
+
+</BODY>
+</HTML>
diff --git a/javadoc/constant-values.html b/javadoc/constant-values.html
new file mode 100644
index 0000000..ab18110
--- /dev/null
+++ b/javadoc/constant-values.html
@@ -0,0 +1,138 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:20 PDT 2009 -->
+<TITLE>
+Constant Field Values
+</TITLE>
+
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="Constant Field Values";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/inject/package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV
+ NEXT</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="index.html?constant-values.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="constant-values.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<CENTER>
+<H1>
+Constant Field Values</H1>
+</CENTER>
+<HR SIZE="4" NOSHADE>
+<B>Contents</B><UL>
+</UL>
+
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/inject/package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV
+ NEXT</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="index.html?constant-values.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="constant-values.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+<font size='-1'>Copyright (C) 2009 <a href='http://code.google.com/p/atinject/'>The JSR-330 Expert Group</a>. Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache License</a>, Version 2.0.</font>
+</BODY>
+</HTML>
diff --git a/javadoc/deprecated-list.html b/javadoc/deprecated-list.html
new file mode 100644
index 0000000..4c96eb7
--- /dev/null
+++ b/javadoc/deprecated-list.html
@@ -0,0 +1,138 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:20 PDT 2009 -->
+<TITLE>
+Deprecated List
+</TITLE>
+
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="Deprecated List";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/inject/package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Deprecated</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV
+ NEXT</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="index.html?deprecated-list.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="deprecated-list.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<CENTER>
+<H2>
+<B>Deprecated API</B></H2>
+</CENTER>
+<HR SIZE="4" NOSHADE>
+<B>Contents</B><UL>
+</UL>
+
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/inject/package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Deprecated</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV
+ NEXT</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="index.html?deprecated-list.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="deprecated-list.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+<font size='-1'>Copyright (C) 2009 <a href='http://code.google.com/p/atinject/'>The JSR-330 Expert Group</a>. Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache License</a>, Version 2.0.</font>
+</BODY>
+</HTML>
diff --git a/javadoc/help-doc.html b/javadoc/help-doc.html
new file mode 100644
index 0000000..f489f5c
--- /dev/null
+++ b/javadoc/help-doc.html
@@ -0,0 +1,205 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:20 PDT 2009 -->
+<TITLE>
+API Help
+</TITLE>
+
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="API Help";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/inject/package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Help</B></FONT> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV
+ NEXT</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="index.html?help-doc.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="help-doc.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<CENTER>
+<H1>
+How This API Document Is Organized</H1>
+</CENTER>
+This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.<H3>
+Package</H3>
+<BLOCKQUOTE>
+
+<P>
+Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain four categories:<UL>
+<LI>Interfaces (italic)<LI>Classes<LI>Enums<LI>Exceptions<LI>Errors<LI>Annotation Types</UL>
+</BLOCKQUOTE>
+<H3>
+Class/Interface</H3>
+<BLOCKQUOTE>
+
+<P>
+Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:<UL>
+<LI>Class inheritance diagram<LI>Direct Subclasses<LI>All Known Subinterfaces<LI>All Known Implementing Classes<LI>Class/interface declaration<LI>Class/interface description
+<P>
+<LI>Nested Class Summary<LI>Field Summary<LI>Constructor Summary<LI>Method Summary
+<P>
+<LI>Field Detail<LI>Constructor Detail<LI>Method Detail</UL>
+Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.</BLOCKQUOTE>
+</BLOCKQUOTE>
+<H3>
+Annotation Type</H3>
+<BLOCKQUOTE>
+
+<P>
+Each annotation type has its own separate page with the following sections:<UL>
+<LI>Annotation Type declaration<LI>Annotation Type description<LI>Required Element Summary<LI>Optional Element Summary<LI>Element Detail</UL>
+</BLOCKQUOTE>
+</BLOCKQUOTE>
+<H3>
+Enum</H3>
+<BLOCKQUOTE>
+
+<P>
+Each enum has its own separate page with the following sections:<UL>
+<LI>Enum declaration<LI>Enum description<LI>Enum Constant Summary<LI>Enum Constant Detail</UL>
+</BLOCKQUOTE>
+<H3>
+Tree (Class Hierarchy)</H3>
+<BLOCKQUOTE>
+There is a <A HREF="overview-tree.html">Class Hierarchy</A> page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with <code>java.lang.Object</code>. The interfaces do not inherit from <code>java.lang.Object</code>.<UL>
+<LI>When viewing the Overview page, clicking on "Tree" displays the hierarchy for all packages.<LI>When viewing a particular package, class or interface page, clicking "Tree" displays the hierarchy for only that package.</UL>
+</BLOCKQUOTE>
+<H3>
+Deprecated API</H3>
+<BLOCKQUOTE>
+The <A HREF="deprecated-list.html">Deprecated API</A> page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.</BLOCKQUOTE>
+<H3>
+Index</H3>
+<BLOCKQUOTE>
+The <A HREF="index-all.html">Index</A> contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.</BLOCKQUOTE>
+<H3>
+Prev/Next</H3>
+These links take you to the next or previous class, interface, package, or related page.<H3>
+Frames/No Frames</H3>
+These links show and hide the HTML frames. All pages are available with or without frames.
+<P>
+<H3>
+Serialized Form</H3>
+Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking "Serialized Form" in the "See also" section of the class description.
+<P>
+<H3>
+Constant Field Values</H3>
+The <a href="constant-values.html">Constant Field Values</a> page lists the static final fields and their values.
+<P>
+<FONT SIZE="-1">
+<EM>
+This help file applies to API documentation generated using the standard doclet.</EM>
+</FONT>
+<BR>
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/inject/package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Help</B></FONT> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV
+ NEXT</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="index.html?help-doc.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="help-doc.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+<font size='-1'>Copyright (C) 2009 <a href='http://code.google.com/p/atinject/'>The JSR-330 Expert Group</a>. Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache License</a>, Version 2.0.</font>
+</BODY>
+</HTML>
diff --git a/javadoc/index-all.html b/javadoc/index-all.html
new file mode 100644
index 0000000..23639fe
--- /dev/null
+++ b/javadoc/index-all.html
@@ -0,0 +1,171 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:20 PDT 2009 -->
+<TITLE>
+Index
+</TITLE>
+
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="./stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="Index";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="./javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="./javax/inject/package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="./deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Index</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="./help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV
+ NEXT</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="./index.html?index-all.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="index-all.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="./allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="./allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<A HREF="#_G_">G</A> <A HREF="#_I_">I</A> <A HREF="#_J_">J</A> <A HREF="#_N_">N</A> <A HREF="#_P_">P</A> <A HREF="#_Q_">Q</A> <A HREF="#_S_">S</A> <HR>
+<A NAME="_G_"><!-- --></A><H2>
+<B>G</B></H2>
+<DL>
+<DT><A HREF="./javax/inject/Provider.html#get()"><B>get()</B></A> -
+Method in interface javax.inject.<A HREF="./javax/inject/Provider.html" title="interface in javax.inject">Provider</A>
+<DD>Provides a fully-constructed and injected instance of <code>T</code>.
+</DL>
+<HR>
+<A NAME="_I_"><!-- --></A><H2>
+<B>I</B></H2>
+<DL>
+<DT><A HREF="./javax/inject/Inject.html" title="annotation in javax.inject"><B>Inject</B></A> - Annotation Type in <A HREF="./javax/inject/package-summary.html">javax.inject</A><DD>Identifies injectable constructors, methods, and fields.</DL>
+<HR>
+<A NAME="_J_"><!-- --></A><H2>
+<B>J</B></H2>
+<DL>
+<DT><A HREF="./javax/inject/package-summary.html"><B>javax.inject</B></A> - package javax.inject<DD>This package specifies a means for obtaining objects in such a way as to
+ maximize reusability, testability and maintainability compared to
+ traditional approaches such as constructors, factories, and service
+ locators (e.g., JNDI). This process, known as <i>dependency
+ injection</i>, is beneficial to most nontrivial applications.</DL>
+<HR>
+<A NAME="_N_"><!-- --></A><H2>
+<B>N</B></H2>
+<DL>
+<DT><A HREF="./javax/inject/Named.html" title="annotation in javax.inject"><B>Named</B></A> - Annotation Type in <A HREF="./javax/inject/package-summary.html">javax.inject</A><DD>String-based <A HREF="./javax/inject/Qualifier.html" title="annotation in javax.inject">qualifier</A>.</DL>
+<HR>
+<A NAME="_P_"><!-- --></A><H2>
+<B>P</B></H2>
+<DL>
+<DT><A HREF="./javax/inject/Provider.html" title="interface in javax.inject"><B>Provider</B></A><<A HREF="./javax/inject/Provider.html" title="type parameter in Provider">T</A>> - Interface in <A HREF="./javax/inject/package-summary.html">javax.inject</A><DD>Provides instances of <code>T</code>.</DL>
+<HR>
+<A NAME="_Q_"><!-- --></A><H2>
+<B>Q</B></H2>
+<DL>
+<DT><A HREF="./javax/inject/Qualifier.html" title="annotation in javax.inject"><B>Qualifier</B></A> - Annotation Type in <A HREF="./javax/inject/package-summary.html">javax.inject</A><DD>Identifies qualifier annotations.</DL>
+<HR>
+<A NAME="_S_"><!-- --></A><H2>
+<B>S</B></H2>
+<DL>
+<DT><A HREF="./javax/inject/Scope.html" title="annotation in javax.inject"><B>Scope</B></A> - Annotation Type in <A HREF="./javax/inject/package-summary.html">javax.inject</A><DD>Identifies scope annotations.<DT><A HREF="./javax/inject/Singleton.html" title="annotation in javax.inject"><B>Singleton</B></A> - Annotation Type in <A HREF="./javax/inject/package-summary.html">javax.inject</A><DD>Identifies a type that the injector only instantiates once.</DL>
+<HR>
+<A HREF="#_G_">G</A> <A HREF="#_I_">I</A> <A HREF="#_J_">J</A> <A HREF="#_N_">N</A> <A HREF="#_P_">P</A> <A HREF="#_Q_">Q</A> <A HREF="#_S_">S</A>
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="./javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="./javax/inject/package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="./deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Index</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="./help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV
+ NEXT</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="./index.html?index-all.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="index-all.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="./allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="./allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+<font size='-1'>Copyright (C) 2009 <a href='http://code.google.com/p/atinject/'>The JSR-330 Expert Group</a>. Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache License</a>, Version 2.0.</font>
+</BODY>
+</HTML>
diff --git a/javadoc/index.html b/javadoc/index.html
new file mode 100644
index 0000000..a5979c3
--- /dev/null
+++ b/javadoc/index.html
@@ -0,0 +1,36 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc on Mon Oct 12 16:11:20 PDT 2009-->
+<TITLE>
+Generated Documentation (Untitled)
+</TITLE>
+<SCRIPT type="text/javascript">
+ targetPage = "" + window.location.search;
+ if (targetPage != "" && targetPage != "undefined")
+ targetPage = targetPage.substring(1);
+ if (targetPage.indexOf(":") != -1)
+ targetPage = "undefined";
+ function loadFrames() {
+ if (targetPage != "" && targetPage != "undefined")
+ top.classFrame.location = top.targetPage;
+ }
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+</HEAD>
+<FRAMESET cols="20%,80%" title="" onLoad="top.loadFrames()">
+<FRAME src="allclasses-frame.html" name="packageFrame" title="All classes and interfaces (except non-static nested types)">
+<FRAME src="javax/inject/package-summary.html" name="classFrame" title="Package, class and interface descriptions" scrolling="yes">
+<NOFRAMES>
+<H2>
+Frame Alert</H2>
+
+<P>
+This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client.
+<BR>
+Link to<A HREF="javax/inject/package-summary.html">Non-frame version.</A>
+</NOFRAMES>
+</FRAMESET>
+</HTML>
diff --git a/javadoc/javax/inject/Inject.html b/javadoc/javax/inject/Inject.html
new file mode 100644
index 0000000..061999e
--- /dev/null
+++ b/javadoc/javax/inject/Inject.html
@@ -0,0 +1,317 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:19 PDT 2009 -->
+<TITLE>
+Inject
+</TITLE>
+
+<META NAME="keywords" CONTENT="javax.inject.Inject class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="Inject";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV CLASS
+ <A HREF="../../javax/inject/Named.html" title="annotation in javax.inject"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/Inject.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="Inject.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: REQUIRED | OPTIONAL</FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: ELEMENT</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+javax.inject</FONT>
+<BR>
+Annotation Type Inject</H2>
+<HR>
+<DL>
+<DT><PRE><FONT SIZE="-1">@Target(value={METHOD,CONSTRUCTOR,FIELD})
+@Retention(value=RUNTIME)
+@Documented
+</FONT>public @interface <B>Inject</B></DL>
+</PRE>
+
+<P>
+Identifies injectable constructors, methods, and fields. May apply to static
+ as well as instance members. An injectable member may have any access
+ modifier (private, package-private, protected, public). Constructors are
+ injected first, followed by fields, and then methods. Fields and methods
+ in superclasses are injected before those in subclasses. Ordering of
+ injection among fields and among methods in the same class is not specified.
+
+ <p>Injectable constructors are annotated with <code>@Inject</code> and accept
+ zero or more dependencies as arguments. <code>@Inject</code> can apply to at most
+ one constructor per class.
+
+ <p><tt><blockquote style="padding-left: 2em; text-indent: -2em;">@Inject
+ <i>ConstructorModifiers<sub>opt</sub></i>
+ <i>SimpleTypeName</i>(<i>FormalParameterList<sub>opt</sub></i>)
+ <i>Throws<sub>opt</sub></i>
+ <i>ConstructorBody</i></blockquote></tt>
+
+ <p><code>@Inject</code> is optional for public, no-argument constructors when no
+ other constructors are present. This enables injectors to invoke default
+ constructors.
+
+ <p><tt><blockquote style="padding-left: 2em; text-indent: -2em;">
+ @Inject<sub><i>opt</i></sub>
+ <i>Annotations<sub>opt</sub></i>
+ public
+ <i>SimpleTypeName</i>()
+ <i>Throws<sub>opt</sub></i>
+ <i>ConstructorBody</i></blockquote></tt>
+
+ <p>Injectable fields:
+ <ul>
+ <li>are annotated with <code>@Inject</code>.
+ <li>are not final.
+ <li>may have any otherwise valid name.</li></ul>
+
+ <p><tt><blockquote style="padding-left: 2em; text-indent: -2em;">@Inject
+ <i>FieldModifiers<sub>opt</sub></i>
+ <i>Type</i>
+ <i>VariableDeclarators</i>;</blockquote></tt>
+
+ <p>Injectable methods:
+ <ul>
+ <li>are annotated with <code>@Inject</code>.</li>
+ <li>are not abstract.</li>
+ <li>do not declare type parameters of their own.</li>
+ <li>may return a result</li>
+ <li>may have any otherwise valid name.</li>
+ <li>accept zero or more dependencies as arguments.</li></ul>
+
+ <p><tt><blockquote style="padding-left: 2em; text-indent: -2em;">@Inject
+ <i>MethodModifiers<sub>opt</sub></i>
+ <i>ResultType</i>
+ <i>Identifier</i>(<i>FormalParameterList<sub>opt</sub></i>)
+ <i>Throws<sub>opt</sub></i>
+ <i>MethodBody</i></blockquote></tt>
+
+ <p>The injector ignores the result of an injected method, but
+ non-<code>void</code> return types are allowed to support use of the method in
+ other contexts (builder-style method chaining, for example).
+
+ <p>Examples:
+
+ <pre>
+ public class Car {
+ // Injectable constructor
+ @Inject public Car(Engine engine) { ... }
+
+ // Injectable field
+ @Inject private Provider<Seat> seatProvider;
+
+ // Injectable package-private method
+ @Inject void install(Windshield windshield, Trunk trunk) { ... }
+ }</pre>
+
+ <p>A method annotated with <code>@Inject</code> that overrides another method
+ annotated with <code>@Inject</code> will only be injected once per injection
+ request per instance. A method with <i>no</i> <code>@Inject</code> annotation
+ that overrides a method annotated with <code>@Inject</code> will not be
+ injected.
+
+ <p>Injection of members annotated with <code>@Inject</code> is required. While an
+ injectable member may use any accessibility modifier (including
+ <tt>private</tt>), platform or injector limitations (like security
+ restrictions or lack of reflection support) might preclude injection
+ of non-public members.
+
+ <h3>Qualifiers</h3>
+
+ <p>A <A HREF="../../javax/inject/Qualifier.html" title="annotation in javax.inject">qualifier</A> may annotate an injectable field
+ or parameter and, combined with the type, identify the implementation to
+ inject. Qualifiers are optional, and when used with <code>@Inject</code> in
+ injector-independent classes, no more than one qualifier should annotate a
+ single field or parameter. The qualifiers are bold in the following example:
+
+ <pre>
+ public class Car {
+ @Inject private <b>@Leather</b> Provider<Seat> seatProvider;
+
+ @Inject void install(<b>@Tinted</b> Windshield windshield,
+ <b>@Big</b> Trunk trunk) { ... }
+ }</pre>
+
+ <p>If one injectable method overrides another, the overriding method's
+ parameters do not automatically inherit qualifiers from the overridden
+ method's parameters.
+
+ <h3>Injectable Values</h3>
+
+ <p>For a given type T and optional qualifier, an injector must be able to
+ inject a user-specified class that:
+
+ <ol type="a">
+ <li>is assignment compatible with T and</li>
+ <li>has an injectable constructor.</li>
+ </ol>
+
+ <p>For example, the user might use external configuration to pick an
+ implementation of T. Beyond that, which values are injected depend upon the
+ injector implementation and its configuration.
+
+ <h3>Circular Dependencies</h3>
+
+ <p>Detecting and resolving circular dependencies is left as an exercise for
+ the injector implementation. Circular dependencies between two constructors
+ is an obvious problem, but you can also have a circular dependency between
+ injectable fields or methods:
+
+ <pre>
+ class A {
+ @Inject B b;
+ }
+ class B {
+ @Inject A a;
+ }</pre>
+
+ <p>When constructing an instance of <code>A</code>, a naive injector
+ implementation might go into an infinite loop constructing an instance of
+ <code>B</code> to set on <code>A</code>, a second instance of <code>A</code> to set on
+ <code>B</code>, a second instance of <code>B</code> to set on the second instance of
+ <code>A</code>, and so on.
+
+ <p>A conservative injector might detect the circular dependency at build
+ time and generate an error, at which point the programmer could break the
+ circular dependency by injecting <A HREF="../../javax/inject/Provider.html" title="interface in javax.inject"><CODE>Provider<A></CODE></A> or <code>Provider<B></code> instead of <code>A</code> or <code>B</code> respectively. Calling <A HREF="../../javax/inject/Provider.html#get()"><CODE>get()</CODE></A> on the provider directly from the constructor or
+ method it was injected into defeats the provider's ability to break up
+ circular dependencies. In the case of method or field injection, scoping
+ one of the dependencies (using <A HREF="../../javax/inject/Singleton.html" title="annotation in javax.inject">singleton scope</A>, for
+ example) may also enable a valid circular relationship.
+<P>
+
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../javax/inject/Qualifier.html" title="annotation in javax.inject"><CODE>@Qualifier</CODE></A>,
+<A HREF="../../javax/inject/Provider.html" title="interface in javax.inject"><CODE>Provider</CODE></A></DL>
+
+<P>
+
+<P>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV CLASS
+ <A HREF="../../javax/inject/Named.html" title="annotation in javax.inject"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/Inject.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="Inject.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: REQUIRED | OPTIONAL</FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: ELEMENT</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+<font size='-1'>Copyright (C) 2009 <a href='http://code.google.com/p/atinject/'>The JSR-330 Expert Group</a>. Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache License</a>, Version 2.0.</font>
+</BODY>
+</HTML>
diff --git a/javadoc/javax/inject/Named.html b/javadoc/javax/inject/Named.html
new file mode 100644
index 0000000..fdb018e
--- /dev/null
+++ b/javadoc/javax/inject/Named.html
@@ -0,0 +1,210 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:19 PDT 2009 -->
+<TITLE>
+Named
+</TITLE>
+
+<META NAME="keywords" CONTENT="javax.inject.Named class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="Named";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../javax/inject/Inject.html" title="annotation in javax.inject"><B>PREV CLASS</B></A>
+ <A HREF="../../javax/inject/Provider.html" title="interface in javax.inject"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/Named.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="Named.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: REQUIRED | <A HREF="#annotation_type_optional_element_summary">OPTIONAL</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#annotation_type_element_detail">ELEMENT</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+javax.inject</FONT>
+<BR>
+Annotation Type Named</H2>
+<HR>
+<DL>
+<DT><PRE><FONT SIZE="-1"><A HREF="../../javax/inject/Qualifier.html" title="annotation in javax.inject">@Qualifier</A>
+@Documented
+@Retention(value=RUNTIME)
+</FONT>public @interface <B>Named</B></DL>
+</PRE>
+
+<P>
+String-based <A HREF="../../javax/inject/Qualifier.html" title="annotation in javax.inject">qualifier</A>.
+
+ <p>Example usage:
+
+ <pre>
+ public class Car {
+ @Inject <b>@Named("driver")</b> Seat driverSeat;
+ @Inject <b>@Named("passenger")</b> Seat passengerSeat;
+ ...
+ }</pre>
+<P>
+
+<P>
+<HR>
+
+<P>
+<!-- =========== ANNOTATION TYPE OPTIONAL MEMBER SUMMARY =========== -->
+
+<A NAME="annotation_type_optional_element_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Optional Element Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.lang.String</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../javax/inject/Named.html#value()">value</A></B></CODE>
+
+<BR>
+ The name.</TD>
+</TR>
+</TABLE>
+
+<P>
+<A NAME="value()"><!-- --></A><H3>
+value</H3>
+<PRE>
+public abstract java.lang.String <B>value</B></PRE>
+<DL>
+<DD>The name.
+<P>
+<DD><DL>
+</DL>
+</DD>
+<DD><DL>
+</DL>
+<DL>
+<DT><B>Default:</B><DD>""</DD>
+</DL>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../javax/inject/Inject.html" title="annotation in javax.inject"><B>PREV CLASS</B></A>
+ <A HREF="../../javax/inject/Provider.html" title="interface in javax.inject"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/Named.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="Named.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: REQUIRED | <A HREF="#annotation_type_optional_element_summary">OPTIONAL</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#annotation_type_element_detail">ELEMENT</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+<font size='-1'>Copyright (C) 2009 <a href='http://code.google.com/p/atinject/'>The JSR-330 Expert Group</a>. Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache License</a>, Version 2.0.</font>
+</BODY>
+</HTML>
diff --git a/javadoc/javax/inject/Provider.html b/javadoc/javax/inject/Provider.html
new file mode 100644
index 0000000..12b3f40
--- /dev/null
+++ b/javadoc/javax/inject/Provider.html
@@ -0,0 +1,234 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:19 PDT 2009 -->
+<TITLE>
+Provider
+</TITLE>
+
+<META NAME="keywords" CONTENT="javax.inject.Provider interface">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="Provider";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../javax/inject/Named.html" title="annotation in javax.inject"><B>PREV CLASS</B></A>
+ <A HREF="../../javax/inject/Qualifier.html" title="annotation in javax.inject"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/Provider.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="Provider.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+javax.inject</FONT>
+<BR>
+Interface Provider<T></H2>
+<HR>
+<DL>
+<DT><PRE>public interface <B>Provider<T></B></DL>
+</PRE>
+
+<P>
+Provides instances of <code>T</code>. Typically implemented by an injector. For
+ any type <code>T</code> that can be injected, you can also inject
+ <code>Provider<T></code>. Compared to injecting <code>T</code> directly, injecting
+ <code>Provider<T></code> enables:
+
+ <ul>
+ <li>retrieving multiple instances.</li>
+ <li>lazy or optional retrieval of an instance.</li>
+ <li>breaking circular dependencies.</li>
+ <li>abstracting scope so you can look up an instance in a smaller scope
+ from an instance in a containing scope.</li>
+ </ul>
+
+ <p>For example:
+
+ <pre>
+ class Car {
+ @Inject Car(Provider<Seat> seatProvider) {
+ Seat driver = seatProvider.get();
+ Seat passenger = seatProvider.get();
+ ...
+ }
+ }</pre>
+<P>
+
+<P>
+<HR>
+
+<P>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../javax/inject/Provider.html" title="type parameter in Provider">T</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../javax/inject/Provider.html#get()">get</A></B>()</CODE>
+
+<BR>
+ Provides a fully-constructed and injected instance of <code>T</code>.</TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TH>
+</TR>
+</TABLE>
+
+<A NAME="get()"><!-- --></A><H3>
+get</H3>
+<PRE>
+<A HREF="../../javax/inject/Provider.html" title="type parameter in Provider">T</A> <B>get</B>()</PRE>
+<DL>
+<DD>Provides a fully-constructed and injected instance of <code>T</code>.
+<P>
+<DD><DL>
+
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.RuntimeException</CODE> - if the injector encounters an error while
+ providing an instance. For example, if an injectable member on
+ <code>T</code> throws an exception, the injector may wrap the exception
+ and throw it to the caller of <code>get()</code>. Callers should not try
+ to handle such exceptions as the behavior may vary across injector
+ implementations and even different configurations of the same injector.</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../javax/inject/Named.html" title="annotation in javax.inject"><B>PREV CLASS</B></A>
+ <A HREF="../../javax/inject/Qualifier.html" title="annotation in javax.inject"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/Provider.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="Provider.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+<font size='-1'>Copyright (C) 2009 <a href='http://code.google.com/p/atinject/'>The JSR-330 Expert Group</a>. Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache License</a>, Version 2.0.</font>
+</BODY>
+</HTML>
diff --git a/javadoc/javax/inject/Qualifier.html b/javadoc/javax/inject/Qualifier.html
new file mode 100644
index 0000000..465959c
--- /dev/null
+++ b/javadoc/javax/inject/Qualifier.html
@@ -0,0 +1,194 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:19 PDT 2009 -->
+<TITLE>
+Qualifier
+</TITLE>
+
+<META NAME="keywords" CONTENT="javax.inject.Qualifier class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="Qualifier";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../javax/inject/Provider.html" title="interface in javax.inject"><B>PREV CLASS</B></A>
+ <A HREF="../../javax/inject/Scope.html" title="annotation in javax.inject"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/Qualifier.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="Qualifier.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: REQUIRED | OPTIONAL</FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: ELEMENT</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+javax.inject</FONT>
+<BR>
+Annotation Type Qualifier</H2>
+<HR>
+<DL>
+<DT><PRE><FONT SIZE="-1">@Target(value=ANNOTATION_TYPE)
+@Retention(value=RUNTIME)
+@Documented
+</FONT>public @interface <B>Qualifier</B></DL>
+</PRE>
+
+<P>
+Identifies qualifier annotations. Anyone can define a new qualifier. A
+ qualifier annotation:
+
+ <ul>
+ <li>is annotated with <code>@Qualifier</code>, <code>@Retention(RUNTIME)</code>,
+ and typically <code>@Documented</code>.</li>
+ <li>can have attributes.</li>
+ <li>may be part of the public API, much like the dependency type, but
+ unlike implementation types which needn't be part of the public
+ API.</li>
+ <li>may have restricted usage if annotated with <code>@Target</code>. While
+ this specification covers applying qualifiers to fields and
+ parameters only, some injector configurations might use qualifier
+ annotations in other places (on methods or classes for example).</li>
+ </ul>
+
+ <p>For example:
+
+ <pre>
+ @java.lang.annotation.Documented
+ @java.lang.annotation.Retention(RUNTIME)
+ @javax.inject.Qualifier
+ public @interface Leather {
+ Color color() default Color.TAN;
+ public enum Color { RED, BLACK, TAN }
+ }</pre>
+<P>
+
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../javax/inject/Named.html" title="annotation in javax.inject"><CODE>@Named</CODE></A></DL>
+
+<P>
+
+<P>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../javax/inject/Provider.html" title="interface in javax.inject"><B>PREV CLASS</B></A>
+ <A HREF="../../javax/inject/Scope.html" title="annotation in javax.inject"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/Qualifier.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="Qualifier.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: REQUIRED | OPTIONAL</FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: ELEMENT</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+<font size='-1'>Copyright (C) 2009 <a href='http://code.google.com/p/atinject/'>The JSR-330 Expert Group</a>. Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache License</a>, Version 2.0.</font>
+</BODY>
+</HTML>
diff --git a/javadoc/javax/inject/Scope.html b/javadoc/javax/inject/Scope.html
new file mode 100644
index 0000000..4919bc8
--- /dev/null
+++ b/javadoc/javax/inject/Scope.html
@@ -0,0 +1,215 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:19 PDT 2009 -->
+<TITLE>
+Scope
+</TITLE>
+
+<META NAME="keywords" CONTENT="javax.inject.Scope class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="Scope";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../javax/inject/Qualifier.html" title="annotation in javax.inject"><B>PREV CLASS</B></A>
+ <A HREF="../../javax/inject/Singleton.html" title="annotation in javax.inject"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/Scope.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="Scope.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: REQUIRED | OPTIONAL</FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: ELEMENT</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+javax.inject</FONT>
+<BR>
+Annotation Type Scope</H2>
+<HR>
+<DL>
+<DT><PRE><FONT SIZE="-1">@Target(value=ANNOTATION_TYPE)
+@Retention(value=RUNTIME)
+@Documented
+</FONT>public @interface <B>Scope</B></DL>
+</PRE>
+
+<P>
+Identifies scope annotations. A scope annotation applies to a class
+ containing an injectable constructor and governs how the injector reuses
+ instances of the type. By default, if no scope annotation is present, the
+ injector creates an instance (by injecting the type's constructor), uses
+ the instance for one injection, and then forgets it. If a scope annotation
+ is present, the injector may retain the instance for possible reuse in a
+ later injection. If multiple threads can access a scoped instance, its
+ implementation should be thread safe. The implementation of the scope
+ itself is left up to the injector.
+
+ <p>In the following example, the scope annotation <code>@Singleton</code> ensures
+ that we only have one Log instance:
+
+ <pre>
+ @Singleton
+ class Log {
+ void log(String message) { ... }
+ }</pre>
+
+ <p>The injector generates an error if it encounters more than one scope
+ annotation on the same class or a scope annotation it doesn't support.
+
+ <p>A scope annotation:
+ <ul>
+ <li>is annotated with <code>@Scope</code>, <code>@Retention(RUNTIME)</code>,
+ and typically <code>@Documented</code>.</li>
+ <li>should not have attributes.</li>
+ <li>is typically not <code>@Inherited</code>, so scoping is orthogonal to
+ implementation inheritance.</li>
+ <li>may have restricted usage if annotated with <code>@Target</code>. While
+ this specification covers applying scopes to classes only, some
+ injector configurations might use scope annotations
+ in other places (on factory method results for example).</li>
+ </ul>
+
+ <p>For example:
+
+ <pre>
+ @java.lang.annotation.Documented
+ @java.lang.annotation.Retention(RUNTIME)
+ @javax.inject.Scope
+ public @interface RequestScoped {}</pre>
+
+ <p>Annotating scope annotations with <code>@Scope</code> helps the injector
+ detect the case where a programmer used the scope annotation on a class but
+ forgot to configure the scope in the injector. A conservative injector
+ would generate an error rather than not apply a scope.
+<P>
+
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../javax/inject/Singleton.html" title="annotation in javax.inject"><CODE>@Singleton</CODE></A></DL>
+
+<P>
+
+<P>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../javax/inject/Qualifier.html" title="annotation in javax.inject"><B>PREV CLASS</B></A>
+ <A HREF="../../javax/inject/Singleton.html" title="annotation in javax.inject"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/Scope.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="Scope.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: REQUIRED | OPTIONAL</FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: ELEMENT</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+<font size='-1'>Copyright (C) 2009 <a href='http://code.google.com/p/atinject/'>The JSR-330 Expert Group</a>. Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache License</a>, Version 2.0.</font>
+</BODY>
+</HTML>
diff --git a/javadoc/javax/inject/Singleton.html b/javadoc/javax/inject/Singleton.html
new file mode 100644
index 0000000..12f9ea6
--- /dev/null
+++ b/javadoc/javax/inject/Singleton.html
@@ -0,0 +1,169 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:19 PDT 2009 -->
+<TITLE>
+Singleton
+</TITLE>
+
+<META NAME="keywords" CONTENT="javax.inject.Singleton class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="Singleton";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../javax/inject/Scope.html" title="annotation in javax.inject"><B>PREV CLASS</B></A>
+ NEXT CLASS</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/Singleton.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="Singleton.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: REQUIRED | OPTIONAL</FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: ELEMENT</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+javax.inject</FONT>
+<BR>
+Annotation Type Singleton</H2>
+<HR>
+<DL>
+<DT><PRE><FONT SIZE="-1"><A HREF="../../javax/inject/Scope.html" title="annotation in javax.inject">@Scope</A>
+@Documented
+@Retention(value=RUNTIME)
+</FONT>public @interface <B>Singleton</B></DL>
+</PRE>
+
+<P>
+Identifies a type that the injector only instantiates once. Not inherited.
+<P>
+
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../javax/inject/Scope.html" title="annotation in javax.inject"><CODE>@Scope</CODE></A></DL>
+
+<P>
+
+<P>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../javax/inject/Scope.html" title="annotation in javax.inject"><B>PREV CLASS</B></A>
+ NEXT CLASS</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/Singleton.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="Singleton.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: REQUIRED | OPTIONAL</FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: ELEMENT</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+<font size='-1'>Copyright (C) 2009 <a href='http://code.google.com/p/atinject/'>The JSR-330 Expert Group</a>. Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache License</a>, Version 2.0.</font>
+</BODY>
+</HTML>
diff --git a/javadoc/javax/inject/package-frame.html b/javadoc/javax/inject/package-frame.html
new file mode 100644
index 0000000..bef990f
--- /dev/null
+++ b/javadoc/javax/inject/package-frame.html
@@ -0,0 +1,51 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:19 PDT 2009 -->
+<TITLE>
+javax.inject
+</TITLE>
+
+<META NAME="keywords" CONTENT="javax.inject package">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
+
+
+</HEAD>
+
+<BODY BGCOLOR="white">
+<FONT size="+1" CLASS="FrameTitleFont">
+<A HREF="../../javax/inject/package-summary.html" target="classFrame">javax.inject</A></FONT>
+<TABLE BORDER="0" WIDTH="100%" SUMMARY="">
+<TR>
+<TD NOWRAP><FONT size="+1" CLASS="FrameHeadingFont">
+Interfaces</FONT>
+<FONT CLASS="FrameItemFont">
+<BR>
+<A HREF="Provider.html" title="interface in javax.inject" target="classFrame"><I>Provider</I></A></FONT></TD>
+</TR>
+</TABLE>
+
+
+<TABLE BORDER="0" WIDTH="100%" SUMMARY="">
+<TR>
+<TD NOWRAP><FONT size="+1" CLASS="FrameHeadingFont">
+Annotation Types</FONT>
+<FONT CLASS="FrameItemFont">
+<BR>
+<A HREF="Inject.html" title="annotation in javax.inject" target="classFrame">Inject</A>
+<BR>
+<A HREF="Named.html" title="annotation in javax.inject" target="classFrame">Named</A>
+<BR>
+<A HREF="Qualifier.html" title="annotation in javax.inject" target="classFrame">Qualifier</A>
+<BR>
+<A HREF="Scope.html" title="annotation in javax.inject" target="classFrame">Scope</A>
+<BR>
+<A HREF="Singleton.html" title="annotation in javax.inject" target="classFrame">Singleton</A></FONT></TD>
+</TR>
+</TABLE>
+
+
+</BODY>
+</HTML>
diff --git a/javadoc/javax/inject/package-summary.html b/javadoc/javax/inject/package-summary.html
new file mode 100644
index 0000000..a1dd828
--- /dev/null
+++ b/javadoc/javax/inject/package-summary.html
@@ -0,0 +1,332 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:20 PDT 2009 -->
+<TITLE>
+javax.inject
+</TITLE>
+
+<META NAME="keywords" CONTENT="javax.inject package">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="javax.inject";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV PACKAGE
+ NEXT PACKAGE</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/package-summary.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<H2>
+Package javax.inject
+</H2>
+This package specifies a means for obtaining objects in such a way as to
+ maximize reusability, testability and maintainability compared to
+ traditional approaches such as constructors, factories, and service
+ locators (e.g., JNDI). This process, known as <i>dependency
+ injection</i>, is beneficial to most nontrivial applications.
+<P>
+<B>See:</B>
+<BR>
+ <A HREF="#package_description"><B>Description</B></A>
+<P>
+
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Interface Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD WIDTH="15%"><B><A HREF="../../javax/inject/Provider.html" title="interface in javax.inject">Provider<T></A></B></TD>
+<TD>Provides instances of <code>T</code>.</TD>
+</TR>
+</TABLE>
+
+
+<P>
+
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
+<B>Annotation Types Summary</B></FONT></TH>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD WIDTH="15%"><B><A HREF="../../javax/inject/Inject.html" title="annotation in javax.inject">Inject</A></B></TD>
+<TD>Identifies injectable constructors, methods, and fields.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD WIDTH="15%"><B><A HREF="../../javax/inject/Named.html" title="annotation in javax.inject">Named</A></B></TD>
+<TD>String-based <A HREF="../../javax/inject/Qualifier.html" title="annotation in javax.inject">qualifier</A>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD WIDTH="15%"><B><A HREF="../../javax/inject/Qualifier.html" title="annotation in javax.inject">Qualifier</A></B></TD>
+<TD>Identifies qualifier annotations.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD WIDTH="15%"><B><A HREF="../../javax/inject/Scope.html" title="annotation in javax.inject">Scope</A></B></TD>
+<TD>Identifies scope annotations.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD WIDTH="15%"><B><A HREF="../../javax/inject/Singleton.html" title="annotation in javax.inject">Singleton</A></B></TD>
+<TD>Identifies a type that the injector only instantiates once.</TD>
+</TR>
+</TABLE>
+
+
+<P>
+<A NAME="package_description"><!-- --></A><H2>
+Package javax.inject Description
+</H2>
+
+<P>
+This package specifies a means for obtaining objects in such a way as to
+ maximize reusability, testability and maintainability compared to
+ traditional approaches such as constructors, factories, and service
+ locators (e.g., JNDI). This process, known as <i>dependency
+ injection</i>, is beneficial to most nontrivial applications.
+
+ <p>Many types depend on other types. For example, a <tt>Stopwatch</tt> might
+ depend on a <tt>TimeSource</tt>. The types on which a type depends are
+ known as its <i>dependencies</i>. The process of finding an instance of a
+ dependency to use at run time is known as <i>resolving</i> the dependency.
+ If no such instance can be found, the dependency is said to be
+ <i>unsatisfied</i>, and the application is broken.
+
+ <p>In the absence of dependency injection, an object can resolve its
+ dependencies in a few ways. It can invoke a constructor, hard-wiring an
+ object directly to its dependency's implementation and life cycle:
+
+ <pre> class Stopwatch {
+ final TimeSource timeSource;
+ Stopwatch () {
+ timeSource = <b>new AtomicClock(...)</b>;
+ }
+ void start() { ... }
+ long stop() { ... }
+ }</pre>
+
+ <p>If more flexibility is needed, the object can call out to a factory or
+ service locator:
+
+ <pre> class Stopwatch {
+ final TimeSource timeSource;
+ Stopwatch () {
+ timeSource = <b>DefaultTimeSource.getInstance()</b>;
+ }
+ void start() { ... }
+ long stop() { ... }
+ }</pre>
+
+ <p>In deciding between these traditional approaches to dependency
+ resolution, a programmer must make trade-offs. Constructors are more
+ concise but restrictive. Factories decouple the client and implementation
+ to some extent but require boilerplate code. Service locators decouple even
+ further but reduce compile time type safety. All three approaches inhibit
+ unit testing. For example, if the programmer uses a factory, each test
+ against code that depends on the factory will have to mock out the factory
+ and remember to clean up after itself or else risk side effects:
+
+ <pre> void testStopwatch() {
+ <b>TimeSource original = DefaultTimeSource.getInstance();
+ DefaultTimeSource.setInstance(new MockTimeSource());
+ try {</b>
+ // Now, we can actually test Stopwatch.
+ Stopwatch sw = new Stopwatch();
+ ...
+ <b>} finally {
+ DefaultTimeSource.setInstance(original);
+ }</b>
+ }</pre>
+
+ <p>In practice, supporting this ability to mock out a factory results in
+ even more boilerplate code. Tests that mock out and clean up after multiple
+ dependencies quickly get out of hand. To make matters worse, a programmer
+ must predict accurately how much flexibility will be needed in the future
+ or else suffer the consequences. If a programmer initially elects to use a
+ constructor but later decides that more flexibility is required, the
+ programmer must replace every call to the constructor. If the programmer
+ errs on the side of caution and write factories up front, it may result in
+ a lot of unnecessary boilerplate code, adding noise, complexity, and
+ error-proneness.
+
+ <p><i>Dependency injection</i> addresses all of these issues. Instead of
+ the programmer calling a constructor or factory, a tool called a
+ <i>dependency injector</i> passes dependencies to objects:
+
+ <pre> class Stopwatch {
+ final TimeSource timeSource;
+ <b>@Inject Stopwatch(TimeSource TimeSource)</b> {
+ this.TimeSource = TimeSource;
+ }
+ void start() { ... }
+ long stop() { ... }
+ }</pre>
+
+ <p>The injector further passes dependencies to other dependencies until it
+ constructs the entire object graph. For example, suppose the programmer
+ asked an injector to create a <tt>StopwatchWidget</tt> instance:
+
+ <pre> /** GUI for a Stopwatch */
+ class StopwatchWidget {
+ @Inject StopwatchWidget(Stopwatch sw) { ... }
+ ...
+ }</pre>
+
+ <p>The injector might:
+ <ol>
+ <li>Find a <tt>TimeSource</tt>
+ <li>Construct a <tt>Stopwatch</tt> with the <tt>TimeSource</tt>
+ <li>Construct a <tt>StopwatchWidget</tt> with the <tt>Stopwatch</tt>
+ </ol>
+
+ <p>This leaves the programmer's code clean, flexible, and relatively free
+ of dependency-related infrastructure.
+
+ <p>In unit tests, the programmer can now construct objects directly
+ (without an injector) and pass in mock dependencies. The programmer no
+ longer needs to set up and tear down factories or service locators in each
+ test. This greatly simplifies our unit test:
+
+ <pre> void testStopwatch() {
+ Stopwatch sw = new Stopwatch(new MockTimeSource());
+ ...
+ }</pre>
+
+ <p>The total decrease in unit-test complexity is proportional to the
+ product of the number of unit tests and the number of dependencies.
+
+ <p><b>This package provides dependency injection annotations that enable
+ portable classes</b>, but it leaves external dependency configuration up to
+ the injector implementation. Programmers annotate constructors, methods,
+ and fields to advertise their injectability (constructor injection is
+ demonstrated in the examples above). A dependency injector identifies a
+ class's dependencies by inspecting these annotations, and injects the
+ dependencies at run time. Moreover, the injector can verify that all
+ dependencies have been satisfied at <i>build time</i>. A service locator,
+ by contrast, cannot detect unsatisfied dependencies until run time.
+
+ <p>Injector implementations can take many forms. An injector could
+ configure itself using XML, annotations, a DSL (domain-specific language),
+ or even plain Java code. An injector could rely on reflection or code
+ generation. An injector that uses compile-time code generation may not even
+ have its own run time representation. Other injectors may not be able to
+ generate code at all, neither at compile nor run time. A "container", for
+ some definition, can be an injector, but this package specification aims to
+ minimize restrictions on injector implementations.
+<P>
+
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../javax/inject/Inject.html" title="annotation in javax.inject"><CODE>@Inject</CODE></A></DL>
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV PACKAGE
+ NEXT PACKAGE</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/package-summary.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+<font size='-1'>Copyright (C) 2009 <a href='http://code.google.com/p/atinject/'>The JSR-330 Expert Group</a>. Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache License</a>, Version 2.0.</font>
+</BODY>
+</HTML>
diff --git a/javadoc/javax/inject/package-tree.html b/javadoc/javax/inject/package-tree.html
new file mode 100644
index 0000000..4c0e056
--- /dev/null
+++ b/javadoc/javax/inject/package-tree.html
@@ -0,0 +1,150 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:20 PDT 2009 -->
+<TITLE>
+javax.inject Class Hierarchy
+</TITLE>
+
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="javax.inject Class Hierarchy";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Tree</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV
+ NEXT</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/package-tree.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="package-tree.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<CENTER>
+<H2>
+Hierarchy For Package javax.inject
+</H2>
+</CENTER>
+<H2>
+Interface Hierarchy
+</H2>
+<UL>
+<LI TYPE="circle">javax.inject.<A HREF="../../javax/inject/Provider.html" title="interface in javax.inject"><B>Provider</B></A><T></UL>
+<H2>
+Annotation Type Hierarchy
+</H2>
+<UL>
+<LI TYPE="circle">javax.inject.<A HREF="../../javax/inject/Singleton.html" title="annotation in javax.inject"><B>Singleton</B></A> (implements java.lang.annotation.Annotation)
+<LI TYPE="circle">javax.inject.<A HREF="../../javax/inject/Scope.html" title="annotation in javax.inject"><B>Scope</B></A> (implements java.lang.annotation.Annotation)
+<LI TYPE="circle">javax.inject.<A HREF="../../javax/inject/Qualifier.html" title="annotation in javax.inject"><B>Qualifier</B></A> (implements java.lang.annotation.Annotation)
+<LI TYPE="circle">javax.inject.<A HREF="../../javax/inject/Named.html" title="annotation in javax.inject"><B>Named</B></A> (implements java.lang.annotation.Annotation)
+<LI TYPE="circle">javax.inject.<A HREF="../../javax/inject/Inject.html" title="annotation in javax.inject"><B>Inject</B></A> (implements java.lang.annotation.Annotation)
+</UL>
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Tree</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV
+ NEXT</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../index.html?javax/inject/package-tree.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="package-tree.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+<font size='-1'>Copyright (C) 2009 <a href='http://code.google.com/p/atinject/'>The JSR-330 Expert Group</a>. Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache License</a>, Version 2.0.</font>
+</BODY>
+</HTML>
diff --git a/javadoc/overview-tree.html b/javadoc/overview-tree.html
new file mode 100644
index 0000000..46726cf
--- /dev/null
+++ b/javadoc/overview-tree.html
@@ -0,0 +1,152 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.5.0_16) on Mon Oct 12 16:11:20 PDT 2009 -->
+<TITLE>
+Class Hierarchy
+</TITLE>
+
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="Class Hierarchy";
+}
+</SCRIPT>
+<NOSCRIPT>
+</NOSCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Tree</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV
+ NEXT</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="index.html?overview-tree.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="overview-tree.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<CENTER>
+<H2>
+Hierarchy For All Packages</H2>
+</CENTER>
+<DL>
+<DT><B>Package Hierarchies:</B><DD><A HREF="javax/inject/package-tree.html">javax.inject</A></DL>
+<HR>
+<H2>
+Interface Hierarchy
+</H2>
+<UL>
+<LI TYPE="circle">javax.inject.<A HREF="javax/inject/Provider.html" title="interface in javax.inject"><B>Provider</B></A><T></UL>
+<H2>
+Annotation Type Hierarchy
+</H2>
+<UL>
+<LI TYPE="circle">javax.inject.<A HREF="javax/inject/Singleton.html" title="annotation in javax.inject"><B>Singleton</B></A> (implements java.lang.annotation.Annotation)
+<LI TYPE="circle">javax.inject.<A HREF="javax/inject/Scope.html" title="annotation in javax.inject"><B>Scope</B></A> (implements java.lang.annotation.Annotation)
+<LI TYPE="circle">javax.inject.<A HREF="javax/inject/Qualifier.html" title="annotation in javax.inject"><B>Qualifier</B></A> (implements java.lang.annotation.Annotation)
+<LI TYPE="circle">javax.inject.<A HREF="javax/inject/Named.html" title="annotation in javax.inject"><B>Named</B></A> (implements java.lang.annotation.Annotation)
+<LI TYPE="circle">javax.inject.<A HREF="javax/inject/Inject.html" title="annotation in javax.inject"><B>Inject</B></A> (implements java.lang.annotation.Annotation)
+</UL>
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="javax/inject/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Tree</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV
+ NEXT</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="index.html?overview-tree.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="overview-tree.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+
+</FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+<font size='-1'>Copyright (C) 2009 <a href='http://code.google.com/p/atinject/'>The JSR-330 Expert Group</a>. Licensed under the <a href='http://www.apache.org/licenses/LICENSE-2.0'>Apache License</a>, Version 2.0.</font>
+</BODY>
+</HTML>
diff --git a/javadoc/package-list b/javadoc/package-list
new file mode 100644
index 0000000..98a4cde
--- /dev/null
+++ b/javadoc/package-list
@@ -0,0 +1 @@
+javax.inject
diff --git a/javadoc/resources/inherit.gif b/javadoc/resources/inherit.gif
new file mode 100644
index 0000000..c814867
--- /dev/null
+++ b/javadoc/resources/inherit.gif
Binary files differ
diff --git a/javadoc/stylesheet.css b/javadoc/stylesheet.css
new file mode 100644
index 0000000..6d31fdb
--- /dev/null
+++ b/javadoc/stylesheet.css
@@ -0,0 +1,29 @@
+/* Javadoc style sheet */
+
+/* Define colors, fonts and other style attributes here to override the defaults */
+
+/* Page background color */
+body { background-color: #FFFFFF }
+
+/* Headings */
+h1 { font-size: 145% }
+
+/* Table colors */
+.TableHeadingColor { background: #CCCCFF } /* Dark mauve */
+.TableSubHeadingColor { background: #EEEEFF } /* Light mauve */
+.TableRowColor { background: #FFFFFF } /* White */
+
+/* Font used in left-hand frame lists */
+.FrameTitleFont { font-size: 100%; font-family: Helvetica, Arial, sans-serif }
+.FrameHeadingFont { font-size: 90%; font-family: Helvetica, Arial, sans-serif }
+.FrameItemFont { font-size: 90%; font-family: Helvetica, Arial, sans-serif }
+
+/* Navigation bar fonts and colors */
+.NavBarCell1 { background-color:#EEEEFF;} /* Light mauve */
+.NavBarCell1Rev { background-color:#00008B;} /* Dark Blue */
+.NavBarFont1 { font-family: Arial, Helvetica, sans-serif; color:#000000;}
+.NavBarFont1Rev { font-family: Arial, Helvetica, sans-serif; color:#FFFFFF;}
+
+.NavBarCell2 { font-family: Arial, Helvetica, sans-serif; background-color:#FFFFFF;}
+.NavBarCell3 { font-family: Arial, Helvetica, sans-serif; background-color:#FFFFFF;}
+
diff --git a/lib/junit-src.jar b/lib/junit-src.jar
new file mode 100644
index 0000000..4cde8b7
--- /dev/null
+++ b/lib/junit-src.jar
Binary files differ
diff --git a/lib/junit.jar b/lib/junit.jar
new file mode 100644
index 0000000..674d71e
--- /dev/null
+++ b/lib/junit.jar
Binary files differ
diff --git a/pom.xml b/pom.xml
new file mode 100644
index 0000000..83658ea
--- /dev/null
+++ b/pom.xml
@@ -0,0 +1,119 @@
+<project>
+ <modelVersion>4.0.0</modelVersion>
+ <groupId>javax.inject</groupId>
+ <artifactId>javax.inject</artifactId>
+ <packaging>jar</packaging>
+ <name>javax.inject</name>
+ <version>1</version>
+ <description>The javax.inject API</description>
+ <url>http://code.google.com/p/atinject/</url>
+ <licenses>
+ <license>
+ <name>The Apache Software License, Version 2.0</name>
+ <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
+ <distribution>repo</distribution>
+ </license>
+ </licenses>
+ <scm>
+ <connection>scm:svn:http://atinject.googlecode.com/svn/trunk</connection>
+ <developerConnection>scm:svn:https://atinject.googlecode.com/svn/trunk</developerConnection>
+ <url>http://code.google.com/p/atinject/source/checkout</url>
+ </scm>
+ <dependencies>
+ <dependency>
+ <groupId>junit</groupId>
+ <artifactId>junit</artifactId>
+ <version>4.7</version>
+ <scope>test</scope>
+ </dependency>
+ </dependencies>
+
+ <build>
+ <sourceDirectory>src</sourceDirectory>
+ <testSourceDirectory>tck</testSourceDirectory>
+ <testResources>
+ <testResource>
+ <directory>tck</directory>
+ <excludes>
+ <exclude>**/*.java</exclude>
+ </excludes>
+ </testResource>
+ </testResources>
+ <pluginManagement>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-compiler-plugin</artifactId>
+ <version>2.1</version>
+ <configuration>
+ <source>1.5</source>
+ <target>1.5</target>
+ <encoding>UTF-8</encoding>
+ <optimize>false</optimize>
+ <debug>true</debug>
+ <showDeprecation>true</showDeprecation>
+ </configuration>
+ </plugin>
+ </plugins>
+ </pluginManagement>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-release-plugin</artifactId>
+ <version>2.0</version>
+ <configuration>
+ <mavenExecutorId>forked-path</mavenExecutorId>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ <developers>
+ <developer>
+ <id>various</id>
+ <name>Various</name>
+ <email>atinject-observer@googlegroups.com</email>
+ <url>http://groups.google.com/group/atinject-observer?pli=1</url>
+ <roles>
+ <role>developer</role>
+ </roles>
+ <timezone>-8</timezone>
+ </developer>
+ </developers>
+ <distributionManagement>
+ <repository>
+ <id>sonatype-nexus-staging</id>
+ <name>Nexus Release Repository</name>
+ <url>http://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
+ </repository>
+ </distributionManagement>
+
+ <profiles>
+ <profile>
+ <id>release-sign-artifacts</id>
+ <activation>
+ <property>
+ <name>performRelease</name>
+ <value>true</value>
+ </property>
+ </activation>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-gpg-plugin</artifactId>
+ <version>1.0</version>
+ <executions>
+ <execution>
+ <id>sign-artifacts</id>
+ <phase>verify</phase>
+ <goals>
+ <goal>sign</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
+ </profile>
+ </profiles>
+</project>
diff --git a/src/javax/inject/Inject.java b/src/javax/inject/Inject.java
new file mode 100644
index 0000000..43458f8
--- /dev/null
+++ b/src/javax/inject/Inject.java
@@ -0,0 +1,185 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.inject;
+
+import java.lang.annotation.Target;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Documented;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.ElementType.CONSTRUCTOR;
+import static java.lang.annotation.ElementType.FIELD;
+
+/**
+ * Identifies injectable constructors, methods, and fields. May apply to static
+ * as well as instance members. An injectable member may have any access
+ * modifier (private, package-private, protected, public). Constructors are
+ * injected first, followed by fields, and then methods. Fields and methods
+ * in superclasses are injected before those in subclasses. Ordering of
+ * injection among fields and among methods in the same class is not specified.
+ *
+ * <p>Injectable constructors are annotated with {@code @Inject} and accept
+ * zero or more dependencies as arguments. {@code @Inject} can apply to at most
+ * one constructor per class.
+ *
+ * <p><tt><blockquote style="padding-left: 2em; text-indent: -2em;">@Inject
+ * <i>ConstructorModifiers<sub>opt</sub></i>
+ * <i>SimpleTypeName</i>(<i>FormalParameterList<sub>opt</sub></i>)
+ * <i>Throws<sub>opt</sub></i>
+ * <i>ConstructorBody</i></blockquote></tt>
+ *
+ * <p>{@code @Inject} is optional for public, no-argument constructors when no
+ * other constructors are present. This enables injectors to invoke default
+ * constructors.
+ *
+ * <p><tt><blockquote style="padding-left: 2em; text-indent: -2em;">
+ * {@literal @}Inject<sub><i>opt</i></sub>
+ * <i>Annotations<sub>opt</sub></i>
+ * public
+ * <i>SimpleTypeName</i>()
+ * <i>Throws<sub>opt</sub></i>
+ * <i>ConstructorBody</i></blockquote></tt>
+ *
+ * <p>Injectable fields:
+ * <ul>
+ * <li>are annotated with {@code @Inject}.
+ * <li>are not final.
+ * <li>may have any otherwise valid name.</li></ul>
+ *
+ * <p><tt><blockquote style="padding-left: 2em; text-indent: -2em;">@Inject
+ * <i>FieldModifiers<sub>opt</sub></i>
+ * <i>Type</i>
+ * <i>VariableDeclarators</i>;</blockquote></tt>
+ *
+ * <p>Injectable methods:
+ * <ul>
+ * <li>are annotated with {@code @Inject}.</li>
+ * <li>are not abstract.</li>
+ * <li>do not declare type parameters of their own.</li>
+ * <li>may return a result</li>
+ * <li>may have any otherwise valid name.</li>
+ * <li>accept zero or more dependencies as arguments.</li></ul>
+ *
+ * <p><tt><blockquote style="padding-left: 2em; text-indent: -2em;">@Inject
+ * <i>MethodModifiers<sub>opt</sub></i>
+ * <i>ResultType</i>
+ * <i>Identifier</i>(<i>FormalParameterList<sub>opt</sub></i>)
+ * <i>Throws<sub>opt</sub></i>
+ * <i>MethodBody</i></blockquote></tt>
+ *
+ * <p>The injector ignores the result of an injected method, but
+ * non-{@code void} return types are allowed to support use of the method in
+ * other contexts (builder-style method chaining, for example).
+ *
+ * <p>Examples:
+ *
+ * <pre>
+ * public class Car {
+ * // Injectable constructor
+ * @Inject public Car(Engine engine) { ... }
+ *
+ * // Injectable field
+ * @Inject private Provider<Seat> seatProvider;
+ *
+ * // Injectable package-private method
+ * @Inject void install(Windshield windshield, Trunk trunk) { ... }
+ * }</pre>
+ *
+ * <p>A method annotated with {@code @Inject} that overrides another method
+ * annotated with {@code @Inject} will only be injected once per injection
+ * request per instance. A method with <i>no</i> {@code @Inject} annotation
+ * that overrides a method annotated with {@code @Inject} will not be
+ * injected.
+ *
+ * <p>Injection of members annotated with {@code @Inject} is required. While an
+ * injectable member may use any accessibility modifier (including
+ * <tt>private</tt>), platform or injector limitations (like security
+ * restrictions or lack of reflection support) might preclude injection
+ * of non-public members.
+ *
+ * <h3>Qualifiers</h3>
+ *
+ * <p>A {@linkplain Qualifier qualifier} may annotate an injectable field
+ * or parameter and, combined with the type, identify the implementation to
+ * inject. Qualifiers are optional, and when used with {@code @Inject} in
+ * injector-independent classes, no more than one qualifier should annotate a
+ * single field or parameter. The qualifiers are bold in the following example:
+ *
+ * <pre>
+ * public class Car {
+ * @Inject private <b>@Leather</b> Provider<Seat> seatProvider;
+ *
+ * @Inject void install(<b>@Tinted</b> Windshield windshield,
+ * <b>@Big</b> Trunk trunk) { ... }
+ * }</pre>
+ *
+ * <p>If one injectable method overrides another, the overriding method's
+ * parameters do not automatically inherit qualifiers from the overridden
+ * method's parameters.
+ *
+ * <h3>Injectable Values</h3>
+ *
+ * <p>For a given type T and optional qualifier, an injector must be able to
+ * inject a user-specified class that:
+ *
+ * <ol type="a">
+ * <li>is assignment compatible with T and</li>
+ * <li>has an injectable constructor.</li>
+ * </ol>
+ *
+ * <p>For example, the user might use external configuration to pick an
+ * implementation of T. Beyond that, which values are injected depend upon the
+ * injector implementation and its configuration.
+ *
+ * <h3>Circular Dependencies</h3>
+ *
+ * <p>Detecting and resolving circular dependencies is left as an exercise for
+ * the injector implementation. Circular dependencies between two constructors
+ * is an obvious problem, but you can also have a circular dependency between
+ * injectable fields or methods:
+ *
+ * <pre>
+ * class A {
+ * @Inject B b;
+ * }
+ * class B {
+ * @Inject A a;
+ * }</pre>
+ *
+ * <p>When constructing an instance of {@code A}, a naive injector
+ * implementation might go into an infinite loop constructing an instance of
+ * {@code B} to set on {@code A}, a second instance of {@code A} to set on
+ * {@code B}, a second instance of {@code B} to set on the second instance of
+ * {@code A}, and so on.
+ *
+ * <p>A conservative injector might detect the circular dependency at build
+ * time and generate an error, at which point the programmer could break the
+ * circular dependency by injecting {@link Provider Provider<A>} or {@code
+ * Provider<B>} instead of {@code A} or {@code B} respectively. Calling {@link
+ * Provider#get() get()} on the provider directly from the constructor or
+ * method it was injected into defeats the provider's ability to break up
+ * circular dependencies. In the case of method or field injection, scoping
+ * one of the dependencies (using {@linkplain Singleton singleton scope}, for
+ * example) may also enable a valid circular relationship.
+ *
+ * @see javax.inject.Qualifier @Qualifier
+ * @see javax.inject.Provider
+ */
+@Target({ METHOD, CONSTRUCTOR, FIELD })
+@Retention(RUNTIME)
+@Documented
+public @interface Inject {}
diff --git a/src/javax/inject/Named.java b/src/javax/inject/Named.java
new file mode 100644
index 0000000..2fb4cab
--- /dev/null
+++ b/src/javax/inject/Named.java
@@ -0,0 +1,42 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.inject;
+
+import java.lang.annotation.Retention;
+import java.lang.annotation.Documented;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+/**
+ * String-based {@linkplain Qualifier qualifier}.
+ *
+ * <p>Example usage:
+ *
+ * <pre>
+ * public class Car {
+ * @Inject <b>@Named("driver")</b> Seat driverSeat;
+ * @Inject <b>@Named("passenger")</b> Seat passengerSeat;
+ * ...
+ * }</pre>
+ */
+@Qualifier
+@Documented
+@Retention(RUNTIME)
+public @interface Named {
+
+ /** The name. */
+ String value() default "";
+}
diff --git a/src/javax/inject/Provider.java b/src/javax/inject/Provider.java
new file mode 100644
index 0000000..271c373
--- /dev/null
+++ b/src/javax/inject/Provider.java
@@ -0,0 +1,57 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.inject;
+
+/**
+ * Provides instances of {@code T}. Typically implemented by an injector. For
+ * any type {@code T} that can be injected, you can also inject
+ * {@code Provider<T>}. Compared to injecting {@code T} directly, injecting
+ * {@code Provider<T>} enables:
+ *
+ * <ul>
+ * <li>retrieving multiple instances.</li>
+ * <li>lazy or optional retrieval of an instance.</li>
+ * <li>breaking circular dependencies.</li>
+ * <li>abstracting scope so you can look up an instance in a smaller scope
+ * from an instance in a containing scope.</li>
+ * </ul>
+ *
+ * <p>For example:
+ *
+ * <pre>
+ * class Car {
+ * @Inject Car(Provider<Seat> seatProvider) {
+ * Seat driver = seatProvider.get();
+ * Seat passenger = seatProvider.get();
+ * ...
+ * }
+ * }</pre>
+ */
+public interface Provider<T> {
+
+ /**
+ * Provides a fully-constructed and injected instance of {@code T}.
+ *
+ * @throws RuntimeException if the injector encounters an error while
+ * providing an instance. For example, if an injectable member on
+ * {@code T} throws an exception, the injector may wrap the exception
+ * and throw it to the caller of {@code get()}. Callers should not try
+ * to handle such exceptions as the behavior may vary across injector
+ * implementations and even different configurations of the same injector.
+ */
+ T get();
+}
diff --git a/src/javax/inject/Qualifier.java b/src/javax/inject/Qualifier.java
new file mode 100644
index 0000000..6b4c42d
--- /dev/null
+++ b/src/javax/inject/Qualifier.java
@@ -0,0 +1,58 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.inject;
+
+import java.lang.annotation.Target;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Documented;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import static java.lang.annotation.ElementType.ANNOTATION_TYPE;
+
+/**
+ * Identifies qualifier annotations. Anyone can define a new qualifier. A
+ * qualifier annotation:
+ *
+ * <ul>
+ * <li>is annotated with {@code @Qualifier}, {@code @Retention(RUNTIME)},
+ * and typically {@code @Documented}.</li>
+ * <li>can have attributes.</li>
+ * <li>may be part of the public API, much like the dependency type, but
+ * unlike implementation types which needn't be part of the public
+ * API.</li>
+ * <li>may have restricted usage if annotated with {@code @Target}. While
+ * this specification covers applying qualifiers to fields and
+ * parameters only, some injector configurations might use qualifier
+ * annotations in other places (on methods or classes for example).</li>
+ * </ul>
+ *
+ * <p>For example:
+ *
+ * <pre>
+ * @java.lang.annotation.Documented
+ * @java.lang.annotation.Retention(RUNTIME)
+ * @javax.inject.Qualifier
+ * public @interface Leather {
+ * Color color() default Color.TAN;
+ * public enum Color { RED, BLACK, TAN }
+ * }</pre>
+ *
+ * @see javax.inject.Named @Named
+ */
+@Target(ANNOTATION_TYPE)
+@Retention(RUNTIME)
+@Documented
+public @interface Qualifier {}
diff --git a/src/javax/inject/Scope.java b/src/javax/inject/Scope.java
new file mode 100644
index 0000000..27133f1
--- /dev/null
+++ b/src/javax/inject/Scope.java
@@ -0,0 +1,79 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.inject;
+
+import java.lang.annotation.Target;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Documented;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import static java.lang.annotation.ElementType.ANNOTATION_TYPE;
+
+/**
+ * Identifies scope annotations. A scope annotation applies to a class
+ * containing an injectable constructor and governs how the injector reuses
+ * instances of the type. By default, if no scope annotation is present, the
+ * injector creates an instance (by injecting the type's constructor), uses
+ * the instance for one injection, and then forgets it. If a scope annotation
+ * is present, the injector may retain the instance for possible reuse in a
+ * later injection. If multiple threads can access a scoped instance, its
+ * implementation should be thread safe. The implementation of the scope
+ * itself is left up to the injector.
+ *
+ * <p>In the following example, the scope annotation {@code @Singleton} ensures
+ * that we only have one Log instance:
+ *
+ * <pre>
+ * @Singleton
+ * class Log {
+ * void log(String message) { ... }
+ * }</pre>
+ *
+ * <p>The injector generates an error if it encounters more than one scope
+ * annotation on the same class or a scope annotation it doesn't support.
+ *
+ * <p>A scope annotation:
+ * <ul>
+ * <li>is annotated with {@code @Scope}, {@code @Retention(RUNTIME)},
+ * and typically {@code @Documented}.</li>
+ * <li>should not have attributes.</li>
+ * <li>is typically not {@code @Inherited}, so scoping is orthogonal to
+ * implementation inheritance.</li>
+ * <li>may have restricted usage if annotated with {@code @Target}. While
+ * this specification covers applying scopes to classes only, some
+ * injector configurations might use scope annotations
+ * in other places (on factory method results for example).</li>
+ * </ul>
+ *
+ * <p>For example:
+ *
+ * <pre>
+ * @java.lang.annotation.Documented
+ * @java.lang.annotation.Retention(RUNTIME)
+ * @javax.inject.Scope
+ * public @interface RequestScoped {}</pre>
+ *
+ * <p>Annotating scope annotations with {@code @Scope} helps the injector
+ * detect the case where a programmer used the scope annotation on a class but
+ * forgot to configure the scope in the injector. A conservative injector
+ * would generate an error rather than not apply a scope.
+ *
+ * @see javax.inject.Singleton @Singleton
+ */
+@Target(ANNOTATION_TYPE)
+@Retention(RUNTIME)
+@Documented
+public @interface Scope {}
diff --git a/src/javax/inject/Singleton.java b/src/javax/inject/Singleton.java
new file mode 100644
index 0000000..a2af7b9
--- /dev/null
+++ b/src/javax/inject/Singleton.java
@@ -0,0 +1,31 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package javax.inject;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+/**
+ * Identifies a type that the injector only instantiates once. Not inherited.
+ *
+ * @see javax.inject.Scope @Scope
+ */
+@Scope
+@Documented
+@Retention(RUNTIME)
+public @interface Singleton {}
diff --git a/src/javax/inject/package-info.java b/src/javax/inject/package-info.java
new file mode 100644
index 0000000..5247410
--- /dev/null
+++ b/src/javax/inject/package-info.java
@@ -0,0 +1,155 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * This package specifies a means for obtaining objects in such a way as to
+ * maximize reusability, testability and maintainability compared to
+ * traditional approaches such as constructors, factories, and service
+ * locators (e.g., JNDI). This process, known as <i>dependency
+ * injection</i>, is beneficial to most nontrivial applications.
+ *
+ * <p>Many types depend on other types. For example, a <tt>Stopwatch</tt> might
+ * depend on a <tt>TimeSource</tt>. The types on which a type depends are
+ * known as its <i>dependencies</i>. The process of finding an instance of a
+ * dependency to use at run time is known as <i>resolving</i> the dependency.
+ * If no such instance can be found, the dependency is said to be
+ * <i>unsatisfied</i>, and the application is broken.
+ *
+ * <p>In the absence of dependency injection, an object can resolve its
+ * dependencies in a few ways. It can invoke a constructor, hard-wiring an
+ * object directly to its dependency's implementation and life cycle:
+ *
+ * <pre> class Stopwatch {
+ * final TimeSource timeSource;
+ * Stopwatch () {
+ * timeSource = <b>new AtomicClock(...)</b>;
+ * }
+ * void start() { ... }
+ * long stop() { ... }
+ * }</pre>
+ *
+ * <p>If more flexibility is needed, the object can call out to a factory or
+ * service locator:
+ *
+ * <pre> class Stopwatch {
+ * final TimeSource timeSource;
+ * Stopwatch () {
+ * timeSource = <b>DefaultTimeSource.getInstance()</b>;
+ * }
+ * void start() { ... }
+ * long stop() { ... }
+ * }</pre>
+ *
+ * <p>In deciding between these traditional approaches to dependency
+ * resolution, a programmer must make trade-offs. Constructors are more
+ * concise but restrictive. Factories decouple the client and implementation
+ * to some extent but require boilerplate code. Service locators decouple even
+ * further but reduce compile time type safety. All three approaches inhibit
+ * unit testing. For example, if the programmer uses a factory, each test
+ * against code that depends on the factory will have to mock out the factory
+ * and remember to clean up after itself or else risk side effects:
+ *
+ * <pre> void testStopwatch() {
+ * <b>TimeSource original = DefaultTimeSource.getInstance();
+ * DefaultTimeSource.setInstance(new MockTimeSource());
+ * try {</b>
+ * // Now, we can actually test Stopwatch.
+ * Stopwatch sw = new Stopwatch();
+ * ...
+ * <b>} finally {
+ * DefaultTimeSource.setInstance(original);
+ * }</b>
+ * }</pre>
+ *
+ * <p>In practice, supporting this ability to mock out a factory results in
+ * even more boilerplate code. Tests that mock out and clean up after multiple
+ * dependencies quickly get out of hand. To make matters worse, a programmer
+ * must predict accurately how much flexibility will be needed in the future
+ * or else suffer the consequences. If a programmer initially elects to use a
+ * constructor but later decides that more flexibility is required, the
+ * programmer must replace every call to the constructor. If the programmer
+ * errs on the side of caution and write factories up front, it may result in
+ * a lot of unnecessary boilerplate code, adding noise, complexity, and
+ * error-proneness.
+ *
+ * <p><i>Dependency injection</i> addresses all of these issues. Instead of
+ * the programmer calling a constructor or factory, a tool called a
+ * <i>dependency injector</i> passes dependencies to objects:
+ *
+ * <pre> class Stopwatch {
+ * final TimeSource timeSource;
+ * <b>@Inject Stopwatch(TimeSource timeSource)</b> {
+ * this.timeSource = timeSource;
+ * }
+ * void start() { ... }
+ * long stop() { ... }
+ * }</pre>
+ *
+ * <p>The injector further passes dependencies to other dependencies until it
+ * constructs the entire object graph. For example, suppose the programmer
+ * asked an injector to create a <tt>StopwatchWidget</tt> instance:
+ *
+ * <pre> /** GUI for a Stopwatch */
+ * class StopwatchWidget {
+ * @Inject StopwatchWidget(Stopwatch sw) { ... }
+ * ...
+ * }</pre>
+ *
+ * <p>The injector might:
+ * <ol>
+ * <li>Find a <tt>TimeSource</tt>
+ * <li>Construct a <tt>Stopwatch</tt> with the <tt>TimeSource</tt>
+ * <li>Construct a <tt>StopwatchWidget</tt> with the <tt>Stopwatch</tt>
+ * </ol>
+ *
+ * <p>This leaves the programmer's code clean, flexible, and relatively free
+ * of dependency-related infrastructure.
+ *
+ * <p>In unit tests, the programmer can now construct objects directly
+ * (without an injector) and pass in mock dependencies. The programmer no
+ * longer needs to set up and tear down factories or service locators in each
+ * test. This greatly simplifies our unit test:
+ *
+ * <pre> void testStopwatch() {
+ * Stopwatch sw = new Stopwatch(new MockTimeSource());
+ * ...
+ * }</pre>
+ *
+ * <p>The total decrease in unit-test complexity is proportional to the
+ * product of the number of unit tests and the number of dependencies.
+ *
+ * <p><b>This package provides dependency injection annotations that enable
+ * portable classes</b>, but it leaves external dependency configuration up to
+ * the injector implementation. Programmers annotate constructors, methods,
+ * and fields to advertise their injectability (constructor injection is
+ * demonstrated in the examples above). A dependency injector identifies a
+ * class's dependencies by inspecting these annotations, and injects the
+ * dependencies at run time. Moreover, the injector can verify that all
+ * dependencies have been satisfied at <i>build time</i>. A service locator,
+ * by contrast, cannot detect unsatisfied dependencies until run time.
+ *
+ * <p>Injector implementations can take many forms. An injector could
+ * configure itself using XML, annotations, a DSL (domain-specific language),
+ * or even plain Java code. An injector could rely on reflection or code
+ * generation. An injector that uses compile-time code generation may not even
+ * have its own run time representation. Other injectors may not be able to
+ * generate code at all, neither at compile nor run time. A "container", for
+ * some definition, can be an injector, but this package specification aims to
+ * minimize restrictions on injector implementations.
+ *
+ * @see javax.inject.Inject @Inject
+ */
+package javax.inject;
diff --git a/tck-pom.xml b/tck-pom.xml
new file mode 100644
index 0000000..e2b172d
--- /dev/null
+++ b/tck-pom.xml
@@ -0,0 +1,122 @@
+<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/maven-v4_0_0.xsd">
+ <modelVersion>4.0.0</modelVersion>
+ <groupId>javax.inject</groupId>
+ <artifactId>javax.inject-tck</artifactId>
+ <packaging>jar</packaging>
+ <name>javax.inject-tck</name>
+ <version>1.1-SNAPSHOT</version>
+ <description>The javax.inject API - TCK</description>
+ <url>http://code.google.com/p/atinject/</url>
+ <licenses>
+ <license>
+ <name>The Apache Software License, Version 2.0</name>
+ <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
+ <distribution>repo</distribution>
+ </license>
+ </licenses>
+ <scm>
+ <connection>scm:svn:http://atinject.googlecode.com/svn/trunk</connection>
+ <developerConnection>scm:svn:https://atinject.googlecode.com/svn/trunk</developerConnection>
+ <url>http://code.google.com/p/atinject/source/checkout</url>
+ </scm>
+ <dependencies>
+ <dependency>
+ <groupId>${pom.groupId}</groupId>
+ <artifactId>javax.inject</artifactId>
+ <version>1</version>
+ </dependency>
+ <dependency>
+ <groupId>junit</groupId>
+ <artifactId>junit</artifactId>
+ <version>4.7</version>
+ </dependency>
+ </dependencies>
+ <build>
+ <sourceDirectory>tck</sourceDirectory>
+ <resources>
+ <resource>
+ <directory>tck</directory>
+ <excludes>
+ <exclude>**/*.java</exclude>
+ <exclude>tck.iml</exclude>
+ </excludes>
+ </resource>
+ </resources>
+ <pluginManagement>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-compiler-plugin</artifactId>
+ <version>2.1</version>
+ <configuration>
+ <source>1.5</source>
+ <target>1.5</target>
+ <encoding>UTF-8</encoding>
+ <optimize>false</optimize>
+ <debug>true</debug>
+ <showDeprecation>true</showDeprecation>
+ </configuration>
+ </plugin>
+ </plugins>
+ </pluginManagement>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-release-plugin</artifactId>
+ <version>2.0</version>
+ <configuration>
+ <mavenExecutorId>forked-path</mavenExecutorId>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ <developers>
+ <developer>
+ <id>various</id>
+ <name>Various</name>
+ <email>atinject-observer@googlegroups.com</email>
+ <url>http://groups.google.com/group/atinject-observer?pli=1</url>
+ <roles>
+ <role>developer</role>
+ </roles>
+ <timezone>-8</timezone>
+ </developer>
+ </developers>
+ <distributionManagement>
+ <repository>
+ <id>sonatype-nexus-staging</id>
+ <name>Nexus Release Repository</name>
+ <url>http://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
+ </repository>
+ </distributionManagement>
+
+ <profiles>
+ <profile>
+ <id>release-sign-artifacts</id>
+ <activation>
+ <property>
+ <name>performRelease</name>
+ <value>true</value>
+ </property>
+ </activation>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-gpg-plugin</artifactId>
+ <version>1.0</version>
+ <executions>
+ <execution>
+ <id>sign-artifacts</id>
+ <phase>verify</phase>
+ <goals>
+ <goal>sign</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
+ </profile>
+ </profiles>
+</project>
diff --git a/tck/org/atinject/tck/Tck.java b/tck/org/atinject/tck/Tck.java
new file mode 100644
index 0000000..76b5465
--- /dev/null
+++ b/tck/org/atinject/tck/Tck.java
@@ -0,0 +1,128 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck;
+
+import org.atinject.tck.auto.Car;
+import org.atinject.tck.auto.Convertible;
+
+import junit.framework.Test;
+import junit.framework.TestSuite;
+
+/**
+ * Manufactures the compatibility test suite. This TCK relies on
+ * <a href="http://junit.org/">JUnit</a>. To integrate the TCK with your
+ * injector, create a JUnit test suite class that passes an injected
+ * {@link Car Car} instance to {@link #testsFor testsFor(Car)}:
+ *
+ * <pre>
+ * import junit.framework.Test;
+ * import org.atinject.tck.Tck;
+ * import org.atinject.tck.auto.Car;
+ *
+ * public class MyTck {
+ * public static Test suite() {
+ * Car car = new MyInjector().getInstance(Car.class);
+ * return Tck.testsFor(car,
+ * true /* supportsStatic */,
+ * true /* supportsPrivate */);
+ * }
+ * }</pre>
+ *
+ * <p>The static {@code suite} method that returns a {@code Test} is a JUnit
+ * convention. Feel free to run the returned tests in other ways.
+ *
+ * <p>Configure the injector as follows:
+ *
+ * <ul>
+ * <li>{@link org.atinject.tck.auto.Car} is implemented by
+ * {@link org.atinject.tck.auto.Convertible Convertible}.
+ * <li>{@link org.atinject.tck.auto.Drivers @Drivers}
+ * {@link org.atinject.tck.auto.Seat Seat} is
+ * implemented by {@link org.atinject.tck.auto.DriversSeat DriversSeat}.
+ * <li>{@link org.atinject.tck.auto.Seat Seat} is
+ * implemented by {@link org.atinject.tck.auto.Seat Seat} itself, and
+ * {@link org.atinject.tck.auto.Tire Tire} by
+ * {@link org.atinject.tck.auto.Tire Tire} itself
+ * (not subclasses).
+ * <li>{@link org.atinject.tck.auto.Engine Engine} is implemented by
+ * {@link org.atinject.tck.auto.V8Engine V8Engine}.
+ * <li>{@link javax.inject.Named @Named("spare")}
+ * {@link org.atinject.tck.auto.Tire Tire} is implemented by
+ * {@link org.atinject.tck.auto.accessories.SpareTire SpareTire}.
+ * <li>The following classes may also be injected directly:
+ * {@link org.atinject.tck.auto.accessories.Cupholder Cupholder},
+ * {@link org.atinject.tck.auto.accessories.SpareTire SpareTire}, and
+ * {@link org.atinject.tck.auto.FuelTank FuelTank}.
+ * </ul>
+ *
+ * <p>Static and private member injection support is optional, but if your
+ * injector supports those features, it must pass the respective tests. If
+ * static member injection is supported, the static members of the following
+ * types shall also be injected once:
+ * {@link org.atinject.tck.auto.Convertible Convertible},
+ * {@link org.atinject.tck.auto.Tire Tire}, and
+ * {@link org.atinject.tck.auto.accessories.SpareTire SpareTire}.
+ *
+ * <p>Use your favorite JUnit tool to run the tests. For example, you can use
+ * your IDE or JUnit's command line runner:
+ *
+ * <pre>
+ * java -cp javax.inject-tck.jar:junit.jar:myinjector.jar \
+ * junit.textui.TestRunner MyTck</pre>
+ */
+public class Tck {
+
+ private Tck() {}
+
+ /**
+ * Constructs a JUnit test suite for the given {@link Car} instance.
+ *
+ * @param car to test
+ * @param supportsStatic true if the injector supports static member
+ * injection
+ * @param supportsPrivate true if the injector supports private member
+ * injection
+ *
+ * @throws NullPointerException if car is null
+ * @throws ClassCastException if car doesn't extend
+ * {@link Convertible Convertible}
+ */
+ public static Test testsFor(Car car, boolean supportsStatic,
+ boolean supportsPrivate) {
+ if (car == null) {
+ throw new NullPointerException("car");
+ }
+
+ if (!(car instanceof Convertible)) {
+ throw new ClassCastException("car doesn't implement Convertible");
+ }
+
+ Convertible.localConvertible.set((Convertible) car);
+ try {
+ TestSuite suite = new TestSuite(Convertible.Tests.class);
+ if (supportsStatic) {
+ suite.addTestSuite(Convertible.StaticTests.class);
+ }
+ if (supportsPrivate) {
+ suite.addTestSuite(Convertible.PrivateTests.class);
+ }
+ return suite;
+ } finally {
+ Convertible.localConvertible.remove();
+ }
+ }
+}
diff --git a/tck/org/atinject/tck/auto/Car.java b/tck/org/atinject/tck/auto/Car.java
new file mode 100644
index 0000000..d312ee5
--- /dev/null
+++ b/tck/org/atinject/tck/auto/Car.java
@@ -0,0 +1,21 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck.auto;
+
+public interface Car {
+
+}
diff --git a/tck/org/atinject/tck/auto/Convertible.java b/tck/org/atinject/tck/auto/Convertible.java
new file mode 100644
index 0000000..b5b7c48
--- /dev/null
+++ b/tck/org/atinject/tck/auto/Convertible.java
@@ -0,0 +1,573 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck.auto;
+
+import junit.framework.TestCase;
+import org.atinject.tck.auto.accessories.Cupholder;
+import org.atinject.tck.auto.accessories.SpareTire;
+import org.atinject.tck.auto.accessories.RoundThing;
+
+import javax.inject.Inject;
+import javax.inject.Named;
+import javax.inject.Provider;
+
+public class Convertible implements Car {
+
+ @Inject @Drivers Seat driversSeatA;
+ @Inject @Drivers Seat driversSeatB;
+ @Inject SpareTire spareTire;
+ @Inject Cupholder cupholder;
+ @Inject Provider<Engine> engineProvider;
+
+ private boolean methodWithZeroParamsInjected;
+ private boolean methodWithMultipleParamsInjected;
+ private boolean methodWithNonVoidReturnInjected;
+
+ private Seat constructorPlainSeat;
+ private Seat constructorDriversSeat;
+ private Tire constructorPlainTire;
+ private Tire constructorSpareTire;
+ private Provider<Seat> constructorPlainSeatProvider = nullProvider();
+ private Provider<Seat> constructorDriversSeatProvider = nullProvider();
+ private Provider<Tire> constructorPlainTireProvider = nullProvider();
+ private Provider<Tire> constructorSpareTireProvider = nullProvider();
+
+ @Inject Seat fieldPlainSeat;
+ @Inject @Drivers Seat fieldDriversSeat;
+ @Inject Tire fieldPlainTire;
+ @Inject @Named("spare") Tire fieldSpareTire;
+ @Inject Provider<Seat> fieldPlainSeatProvider = nullProvider();
+ @Inject @Drivers Provider<Seat> fieldDriversSeatProvider = nullProvider();
+ @Inject Provider<Tire> fieldPlainTireProvider = nullProvider();
+ @Inject @Named("spare") Provider<Tire> fieldSpareTireProvider = nullProvider();
+
+ private Seat methodPlainSeat;
+ private Seat methodDriversSeat;
+ private Tire methodPlainTire;
+ private Tire methodSpareTire;
+ private Provider<Seat> methodPlainSeatProvider = nullProvider();
+ private Provider<Seat> methodDriversSeatProvider = nullProvider();
+ private Provider<Tire> methodPlainTireProvider = nullProvider();
+ private Provider<Tire> methodSpareTireProvider = nullProvider();
+
+ @Inject static Seat staticFieldPlainSeat;
+ @Inject @Drivers static Seat staticFieldDriversSeat;
+ @Inject static Tire staticFieldPlainTire;
+ @Inject @Named("spare") static Tire staticFieldSpareTire;
+ @Inject static Provider<Seat> staticFieldPlainSeatProvider = nullProvider();
+ @Inject @Drivers static Provider<Seat> staticFieldDriversSeatProvider = nullProvider();
+ @Inject static Provider<Tire> staticFieldPlainTireProvider = nullProvider();
+ @Inject @Named("spare") static Provider<Tire> staticFieldSpareTireProvider = nullProvider();
+
+ private static Seat staticMethodPlainSeat;
+ private static Seat staticMethodDriversSeat;
+ private static Tire staticMethodPlainTire;
+ private static Tire staticMethodSpareTire;
+ private static Provider<Seat> staticMethodPlainSeatProvider = nullProvider();
+ private static Provider<Seat> staticMethodDriversSeatProvider = nullProvider();
+ private static Provider<Tire> staticMethodPlainTireProvider = nullProvider();
+ private static Provider<Tire> staticMethodSpareTireProvider = nullProvider();
+
+ @Inject Convertible(
+ Seat plainSeat,
+ @Drivers Seat driversSeat,
+ Tire plainTire,
+ @Named("spare") Tire spareTire,
+ Provider<Seat> plainSeatProvider,
+ @Drivers Provider<Seat> driversSeatProvider,
+ Provider<Tire> plainTireProvider,
+ @Named("spare") Provider<Tire> spareTireProvider) {
+ constructorPlainSeat = plainSeat;
+ constructorDriversSeat = driversSeat;
+ constructorPlainTire = plainTire;
+ constructorSpareTire = spareTire;
+ constructorPlainSeatProvider = plainSeatProvider;
+ constructorDriversSeatProvider = driversSeatProvider;
+ constructorPlainTireProvider = plainTireProvider;
+ constructorSpareTireProvider = spareTireProvider;
+ }
+
+ Convertible() {
+ throw new AssertionError("Unexpected call to non-injectable constructor");
+ }
+
+ void setSeat(Seat unused) {
+ throw new AssertionError("Unexpected call to non-injectable method");
+ }
+
+ @Inject void injectMethodWithZeroArgs() {
+ methodWithZeroParamsInjected = true;
+ }
+
+ @Inject String injectMethodWithNonVoidReturn() {
+ methodWithNonVoidReturnInjected = true;
+ return "unused";
+ }
+
+ @Inject void injectInstanceMethodWithManyArgs(
+ Seat plainSeat,
+ @Drivers Seat driversSeat,
+ Tire plainTire,
+ @Named("spare") Tire spareTire,
+ Provider<Seat> plainSeatProvider,
+ @Drivers Provider<Seat> driversSeatProvider,
+ Provider<Tire> plainTireProvider,
+ @Named("spare") Provider<Tire> spareTireProvider) {
+ methodWithMultipleParamsInjected = true;
+
+ methodPlainSeat = plainSeat;
+ methodDriversSeat = driversSeat;
+ methodPlainTire = plainTire;
+ methodSpareTire = spareTire;
+ methodPlainSeatProvider = plainSeatProvider;
+ methodDriversSeatProvider = driversSeatProvider;
+ methodPlainTireProvider = plainTireProvider;
+ methodSpareTireProvider = spareTireProvider;
+ }
+
+ @Inject static void injectStaticMethodWithManyArgs(
+ Seat plainSeat,
+ @Drivers Seat driversSeat,
+ Tire plainTire,
+ @Named("spare") Tire spareTire,
+ Provider<Seat> plainSeatProvider,
+ @Drivers Provider<Seat> driversSeatProvider,
+ Provider<Tire> plainTireProvider,
+ @Named("spare") Provider<Tire> spareTireProvider) {
+ staticMethodPlainSeat = plainSeat;
+ staticMethodDriversSeat = driversSeat;
+ staticMethodPlainTire = plainTire;
+ staticMethodSpareTire = spareTire;
+ staticMethodPlainSeatProvider = plainSeatProvider;
+ staticMethodDriversSeatProvider = driversSeatProvider;
+ staticMethodPlainTireProvider = plainTireProvider;
+ staticMethodSpareTireProvider = spareTireProvider;
+ }
+
+ /**
+ * Returns a provider that always returns null. This is used as a default
+ * value to avoid null checks for omitted provider injections.
+ */
+ private static <T> Provider<T> nullProvider() {
+ return new Provider<T>() {
+ public T get() {
+ return null;
+ }
+ };
+ }
+
+ public static ThreadLocal<Convertible> localConvertible
+ = new ThreadLocal<Convertible>();
+
+ public static class Tests extends TestCase {
+
+ private final Convertible car = localConvertible.get();
+ private final Cupholder cupholder = car.cupholder;
+ private final SpareTire spareTire = car.spareTire;
+ private final Tire plainTire = car.fieldPlainTire;
+ private final Engine engine = car.engineProvider.get();
+
+ // smoke tests: if these fail all bets are off
+
+ public void testFieldsInjected() {
+ assertTrue(cupholder != null && spareTire != null);
+ }
+
+ public void testProviderReturnedValues() {
+ assertTrue(engine != null);
+ }
+
+ // injecting different kinds of members
+
+ public void testMethodWithZeroParametersInjected() {
+ assertTrue(car.methodWithZeroParamsInjected);
+ }
+
+ public void testMethodWithMultipleParametersInjected() {
+ assertTrue(car.methodWithMultipleParamsInjected);
+ }
+
+ public void testNonVoidMethodInjected() {
+ assertTrue(car.methodWithNonVoidReturnInjected);
+ }
+
+ public void testPublicNoArgsConstructorInjected() {
+ assertTrue(engine.publicNoArgsConstructorInjected);
+ }
+
+ public void testSubtypeFieldsInjected() {
+ assertTrue(spareTire.hasSpareTireBeenFieldInjected());
+ }
+
+ public void testSubtypeMethodsInjected() {
+ assertTrue(spareTire.hasSpareTireBeenMethodInjected());
+ }
+
+ public void testSupertypeFieldsInjected() {
+ assertTrue(spareTire.hasTireBeenFieldInjected());
+ }
+
+ public void testSupertypeMethodsInjected() {
+ assertTrue(spareTire.hasTireBeenMethodInjected());
+ }
+
+ public void testTwiceOverriddenMethodInjectedWhenMiddleLacksAnnotation() {
+ assertTrue(engine.overriddenTwiceWithOmissionInMiddleInjected);
+ }
+
+ // injected values
+
+ public void testQualifiersNotInheritedFromOverriddenMethod() {
+ assertFalse(engine.qualifiersInheritedFromOverriddenMethod);
+ }
+
+ public void testConstructorInjectionWithValues() {
+ assertFalse("Expected unqualified value",
+ car.constructorPlainSeat instanceof DriversSeat);
+ assertFalse("Expected unqualified value",
+ car.constructorPlainTire instanceof SpareTire);
+ assertTrue("Expected qualified value",
+ car.constructorDriversSeat instanceof DriversSeat);
+ assertTrue("Expected qualified value",
+ car.constructorSpareTire instanceof SpareTire);
+ }
+
+ public void testFieldInjectionWithValues() {
+ assertFalse("Expected unqualified value",
+ car.fieldPlainSeat instanceof DriversSeat);
+ assertFalse("Expected unqualified value",
+ car.fieldPlainTire instanceof SpareTire);
+ assertTrue("Expected qualified value",
+ car.fieldDriversSeat instanceof DriversSeat);
+ assertTrue("Expected qualified value",
+ car.fieldSpareTire instanceof SpareTire);
+ }
+
+ public void testMethodInjectionWithValues() {
+ assertFalse("Expected unqualified value",
+ car.methodPlainSeat instanceof DriversSeat);
+ assertFalse("Expected unqualified value",
+ car.methodPlainTire instanceof SpareTire);
+ assertTrue("Expected qualified value",
+ car.methodDriversSeat instanceof DriversSeat);
+ assertTrue("Expected qualified value",
+ car.methodSpareTire instanceof SpareTire);
+ }
+
+ // injected providers
+
+ public void testConstructorInjectionWithProviders() {
+ assertFalse("Expected unqualified value",
+ car.constructorPlainSeatProvider.get() instanceof DriversSeat);
+ assertFalse("Expected unqualified value",
+ car.constructorPlainTireProvider.get() instanceof SpareTire);
+ assertTrue("Expected qualified value",
+ car.constructorDriversSeatProvider.get() instanceof DriversSeat);
+ assertTrue("Expected qualified value",
+ car.constructorSpareTireProvider.get() instanceof SpareTire);
+ }
+
+ public void testFieldInjectionWithProviders() {
+ assertFalse("Expected unqualified value",
+ car.fieldPlainSeatProvider.get() instanceof DriversSeat);
+ assertFalse("Expected unqualified value",
+ car.fieldPlainTireProvider.get() instanceof SpareTire);
+ assertTrue("Expected qualified value",
+ car.fieldDriversSeatProvider.get() instanceof DriversSeat);
+ assertTrue("Expected qualified value",
+ car.fieldSpareTireProvider.get() instanceof SpareTire);
+ }
+
+ public void testMethodInjectionWithProviders() {
+ assertFalse("Expected unqualified value",
+ car.methodPlainSeatProvider.get() instanceof DriversSeat);
+ assertFalse("Expected unqualified value",
+ car.methodPlainTireProvider.get() instanceof SpareTire);
+ assertTrue("Expected qualified value",
+ car.methodDriversSeatProvider.get() instanceof DriversSeat);
+ assertTrue("Expected qualified value",
+ car.methodSpareTireProvider.get() instanceof SpareTire);
+ }
+
+
+ // singletons
+
+ public void testConstructorInjectedProviderYieldsSingleton() {
+ assertSame("Expected same value",
+ car.constructorPlainSeatProvider.get(), car.constructorPlainSeatProvider.get());
+ }
+
+ public void testFieldInjectedProviderYieldsSingleton() {
+ assertSame("Expected same value",
+ car.fieldPlainSeatProvider.get(), car.fieldPlainSeatProvider.get());
+ }
+
+ public void testMethodInjectedProviderYieldsSingleton() {
+ assertSame("Expected same value",
+ car.methodPlainSeatProvider.get(), car.methodPlainSeatProvider.get());
+ }
+
+ public void testCircularlyDependentSingletons() {
+ // uses provider.get() to get around circular deps
+ assertSame(cupholder.seatProvider.get().getCupholder(), cupholder);
+ }
+
+
+ // non singletons
+
+ public void testSingletonAnnotationNotInheritedFromSupertype() {
+ assertNotSame(car.driversSeatA, car.driversSeatB);
+ }
+
+ public void testConstructorInjectedProviderYieldsDistinctValues() {
+ assertNotSame("Expected distinct values",
+ car.constructorDriversSeatProvider.get(), car.constructorDriversSeatProvider.get());
+ assertNotSame("Expected distinct values",
+ car.constructorPlainTireProvider.get(), car.constructorPlainTireProvider.get());
+ assertNotSame("Expected distinct values",
+ car.constructorSpareTireProvider.get(), car.constructorSpareTireProvider.get());
+ }
+
+ public void testFieldInjectedProviderYieldsDistinctValues() {
+ assertNotSame("Expected distinct values",
+ car.fieldDriversSeatProvider.get(), car.fieldDriversSeatProvider.get());
+ assertNotSame("Expected distinct values",
+ car.fieldPlainTireProvider.get(), car.fieldPlainTireProvider.get());
+ assertNotSame("Expected distinct values",
+ car.fieldSpareTireProvider.get(), car.fieldSpareTireProvider.get());
+ }
+
+ public void testMethodInjectedProviderYieldsDistinctValues() {
+ assertNotSame("Expected distinct values",
+ car.methodDriversSeatProvider.get(), car.methodDriversSeatProvider.get());
+ assertNotSame("Expected distinct values",
+ car.methodPlainTireProvider.get(), car.methodPlainTireProvider.get());
+ assertNotSame("Expected distinct values",
+ car.methodSpareTireProvider.get(), car.methodSpareTireProvider.get());
+ }
+
+
+ // mix inheritance + visibility
+
+ public void testPackagePrivateMethodInjectedDifferentPackages() {
+ assertTrue(spareTire.subPackagePrivateMethodInjected);
+ assertTrue(spareTire.superPackagePrivateMethodInjected);
+ }
+
+ public void testOverriddenProtectedMethodInjection() {
+ assertTrue(spareTire.subProtectedMethodInjected);
+ assertFalse(spareTire.superProtectedMethodInjected);
+ }
+
+ public void testOverriddenPublicMethodNotInjected() {
+ assertTrue(spareTire.subPublicMethodInjected);
+ assertFalse(spareTire.superPublicMethodInjected);
+ }
+
+
+ // inject in order
+
+ public void testFieldsInjectedBeforeMethods() {
+ assertFalse(spareTire.methodInjectedBeforeFields);
+ }
+
+ public void testSupertypeMethodsInjectedBeforeSubtypeFields() {
+ assertFalse(spareTire.subtypeFieldInjectedBeforeSupertypeMethods);
+ }
+
+ public void testSupertypeMethodInjectedBeforeSubtypeMethods() {
+ assertFalse(spareTire.subtypeMethodInjectedBeforeSupertypeMethods);
+ }
+
+
+ // necessary injections occur
+
+ public void testPackagePrivateMethodInjectedEvenWhenSimilarMethodLacksAnnotation() {
+ assertTrue(spareTire.subPackagePrivateMethodForOverrideInjected);
+ }
+
+
+ // override or similar method without @Inject
+
+ public void testPrivateMethodNotInjectedWhenSupertypeHasAnnotatedSimilarMethod() {
+ assertFalse(spareTire.superPrivateMethodForOverrideInjected);
+ }
+
+ public void testPackagePrivateMethodNotInjectedWhenOverrideLacksAnnotation() {
+ assertFalse(engine.subPackagePrivateMethodForOverrideInjected);
+ assertFalse(engine.superPackagePrivateMethodForOverrideInjected);
+ }
+
+ public void testPackagePrivateMethodNotInjectedWhenSupertypeHasAnnotatedSimilarMethod() {
+ assertFalse(spareTire.superPackagePrivateMethodForOverrideInjected);
+ }
+
+ public void testProtectedMethodNotInjectedWhenOverrideNotAnnotated() {
+ assertFalse(spareTire.protectedMethodForOverrideInjected);
+ }
+
+ public void testPublicMethodNotInjectedWhenOverrideNotAnnotated() {
+ assertFalse(spareTire.publicMethodForOverrideInjected);
+ }
+
+ public void testTwiceOverriddenMethodNotInjectedWhenOverrideLacksAnnotation() {
+ assertFalse(engine.overriddenTwiceWithOmissionInSubclassInjected);
+ }
+
+ public void testOverriddingMixedWithPackagePrivate2() {
+ assertTrue(spareTire.packagePrivateMethod2Injected);
+ assertTrue(((Tire) spareTire).packagePrivateMethod2Injected);
+ assertFalse(((RoundThing) spareTire).packagePrivateMethod2Injected);
+
+ assertTrue(plainTire.packagePrivateMethod2Injected);
+ assertTrue(((RoundThing) plainTire).packagePrivateMethod2Injected);
+ }
+
+ public void testOverriddingMixedWithPackagePrivate3() {
+ assertFalse(spareTire.packagePrivateMethod3Injected);
+ assertTrue(((Tire) spareTire).packagePrivateMethod3Injected);
+ assertFalse(((RoundThing) spareTire).packagePrivateMethod3Injected);
+
+ assertTrue(plainTire.packagePrivateMethod3Injected);
+ assertTrue(((RoundThing) plainTire).packagePrivateMethod3Injected);
+ }
+
+ public void testOverriddingMixedWithPackagePrivate4() {
+ assertFalse(plainTire.packagePrivateMethod4Injected);
+ assertTrue(((RoundThing) plainTire).packagePrivateMethod4Injected);
+ }
+
+ // inject only once
+
+ public void testOverriddenPackagePrivateMethodInjectedOnlyOnce() {
+ assertFalse(engine.overriddenPackagePrivateMethodInjectedTwice);
+ }
+
+ public void testSimilarPackagePrivateMethodInjectedOnlyOnce() {
+ assertFalse(spareTire.similarPackagePrivateMethodInjectedTwice);
+ }
+
+ public void testOverriddenProtectedMethodInjectedOnlyOnce() {
+ assertFalse(spareTire.overriddenProtectedMethodInjectedTwice);
+ }
+
+ public void testOverriddenPublicMethodInjectedOnlyOnce() {
+ assertFalse(spareTire.overriddenPublicMethodInjectedTwice);
+ }
+
+ }
+
+ public static class StaticTests extends TestCase {
+
+ public void testSubtypeStaticFieldsInjected() {
+ assertTrue(SpareTire.hasBeenStaticFieldInjected());
+ }
+
+ public void testSubtypeStaticMethodsInjected() {
+ assertTrue(SpareTire.hasBeenStaticMethodInjected());
+ }
+
+ public void testSupertypeStaticFieldsInjected() {
+ assertTrue(Tire.hasBeenStaticFieldInjected());
+ }
+
+ public void testSupertypeStaticMethodsInjected() {
+ assertTrue(Tire.hasBeenStaticMethodInjected());
+ }
+
+ public void testStaticFieldInjectionWithValues() {
+ assertFalse("Expected unqualified value",
+ staticFieldPlainSeat instanceof DriversSeat);
+ assertFalse("Expected unqualified value",
+ staticFieldPlainTire instanceof SpareTire);
+ assertTrue("Expected qualified value",
+ staticFieldDriversSeat instanceof DriversSeat);
+ assertTrue("Expected qualified value",
+ staticFieldSpareTire instanceof SpareTire);
+ }
+
+ public void testStaticMethodInjectionWithValues() {
+ assertFalse("Expected unqualified value",
+ staticMethodPlainSeat instanceof DriversSeat);
+ assertFalse("Expected unqualified value",
+ staticMethodPlainTire instanceof SpareTire);
+ assertTrue("Expected qualified value",
+ staticMethodDriversSeat instanceof DriversSeat);
+ assertTrue("Expected qualified value",
+ staticMethodSpareTire instanceof SpareTire);
+ }
+
+ public void testStaticFieldsInjectedBeforeMethods() {
+ assertFalse(SpareTire.staticMethodInjectedBeforeStaticFields);
+ }
+
+ public void testSupertypeStaticMethodsInjectedBeforeSubtypeStaticFields() {
+ assertFalse(SpareTire.subtypeStaticFieldInjectedBeforeSupertypeStaticMethods);
+ }
+
+ public void testSupertypeStaticMethodsInjectedBeforeSubtypeStaticMethods() {
+ assertFalse(SpareTire.subtypeStaticMethodInjectedBeforeSupertypeStaticMethods);
+ }
+
+ public void testStaticFieldInjectionWithProviders() {
+ assertFalse("Expected unqualified value",
+ staticFieldPlainSeatProvider.get() instanceof DriversSeat);
+ assertFalse("Expected unqualified value",
+ staticFieldPlainTireProvider.get() instanceof SpareTire);
+ assertTrue("Expected qualified value",
+ staticFieldDriversSeatProvider.get() instanceof DriversSeat);
+ assertTrue("Expected qualified value",
+ staticFieldSpareTireProvider.get() instanceof SpareTire);
+ }
+
+ public void testStaticMethodInjectionWithProviders() {
+ assertFalse("Expected unqualified value",
+ staticMethodPlainSeatProvider.get() instanceof DriversSeat);
+ assertFalse("Expected unqualified value",
+ staticMethodPlainTireProvider.get() instanceof SpareTire);
+ assertTrue("Expected qualified value",
+ staticMethodDriversSeatProvider.get() instanceof DriversSeat);
+ assertTrue("Expected qualified value",
+ staticMethodSpareTireProvider.get() instanceof SpareTire);
+ }
+ }
+
+ public static class PrivateTests extends TestCase {
+
+ private final Convertible car = localConvertible.get();
+ private final Engine engine = car.engineProvider.get();
+ private final SpareTire spareTire = car.spareTire;
+
+ public void testSupertypePrivateMethodInjected() {
+ assertTrue(spareTire.superPrivateMethodInjected);
+ assertTrue(spareTire.subPrivateMethodInjected);
+ }
+
+ public void testPackagePrivateMethodInjectedSamePackage() {
+ assertTrue(engine.subPackagePrivateMethodInjected);
+ assertFalse(engine.superPackagePrivateMethodInjected);
+ }
+
+ public void testPrivateMethodInjectedEvenWhenSimilarMethodLacksAnnotation() {
+ assertTrue(spareTire.subPrivateMethodForOverrideInjected);
+ }
+
+ public void testSimilarPrivateMethodInjectedOnlyOnce() {
+ assertFalse(spareTire.similarPrivateMethodInjectedTwice);
+ }
+ }
+}
diff --git a/tck/org/atinject/tck/auto/Drivers.java b/tck/org/atinject/tck/auto/Drivers.java
new file mode 100644
index 0000000..53a2dc0
--- /dev/null
+++ b/tck/org/atinject/tck/auto/Drivers.java
@@ -0,0 +1,25 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck.auto;
+
+import javax.inject.Qualifier;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+
+@Retention(RetentionPolicy.RUNTIME) @Qualifier
+public @interface Drivers {
+}
diff --git a/tck/org/atinject/tck/auto/DriversSeat.java b/tck/org/atinject/tck/auto/DriversSeat.java
new file mode 100644
index 0000000..3ba90d9
--- /dev/null
+++ b/tck/org/atinject/tck/auto/DriversSeat.java
@@ -0,0 +1,29 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck.auto;
+
+import org.atinject.tck.auto.accessories.Cupholder;
+
+import javax.inject.Inject;
+
+public class DriversSeat extends Seat {
+
+ @Inject
+ public DriversSeat(Cupholder cupholder) {
+ super(cupholder);
+ }
+}
diff --git a/tck/org/atinject/tck/auto/Engine.java b/tck/org/atinject/tck/auto/Engine.java
new file mode 100644
index 0000000..e4231e5
--- /dev/null
+++ b/tck/org/atinject/tck/auto/Engine.java
@@ -0,0 +1,68 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck.auto;
+
+import org.atinject.tck.auto.accessories.SpareTire;
+
+import javax.inject.Inject;
+import javax.inject.Named;
+
+public abstract class Engine {
+
+ protected boolean publicNoArgsConstructorInjected;
+ protected boolean subPackagePrivateMethodInjected;
+ protected boolean superPackagePrivateMethodInjected;
+ protected boolean subPackagePrivateMethodForOverrideInjected;
+ protected boolean superPackagePrivateMethodForOverrideInjected;
+
+ protected boolean overriddenTwiceWithOmissionInMiddleInjected;
+ protected boolean overriddenTwiceWithOmissionInSubclassInjected;
+
+ protected Seat seatA;
+ protected Seat seatB;
+ protected Tire tireA;
+ protected Tire tireB;
+
+ public boolean overriddenPackagePrivateMethodInjectedTwice;
+ public boolean qualifiersInheritedFromOverriddenMethod;
+
+ @Inject void injectPackagePrivateMethod() {
+ superPackagePrivateMethodInjected = true;
+ }
+
+ @Inject void injectPackagePrivateMethodForOverride() {
+ superPackagePrivateMethodForOverrideInjected = true;
+ }
+
+ @Inject public void injectQualifiers(@Drivers Seat seatA, Seat seatB,
+ @Named("spare") Tire tireA, Tire tireB) {
+ if (!(seatA instanceof DriversSeat)
+ || (seatB instanceof DriversSeat)
+ || !(tireA instanceof SpareTire)
+ || (tireB instanceof SpareTire)) {
+ qualifiersInheritedFromOverriddenMethod = true;
+ }
+ }
+
+ @Inject public void injectTwiceOverriddenWithOmissionInMiddle() {
+ overriddenTwiceWithOmissionInMiddleInjected = true;
+ }
+
+ @Inject public void injectTwiceOverriddenWithOmissionInSubclass() {
+ overriddenTwiceWithOmissionInSubclassInjected = true;
+ }
+}
diff --git a/tck/org/atinject/tck/auto/FuelTank.java b/tck/org/atinject/tck/auto/FuelTank.java
new file mode 100644
index 0000000..37d5199
--- /dev/null
+++ b/tck/org/atinject/tck/auto/FuelTank.java
@@ -0,0 +1,21 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck.auto;
+
+public class FuelTank {
+
+}
diff --git a/tck/org/atinject/tck/auto/GasEngine.java b/tck/org/atinject/tck/auto/GasEngine.java
new file mode 100644
index 0000000..6f7edf1
--- /dev/null
+++ b/tck/org/atinject/tck/auto/GasEngine.java
@@ -0,0 +1,30 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck.auto;
+
+import javax.inject.Inject;
+
+public abstract class GasEngine extends Engine {
+
+ public void injectTwiceOverriddenWithOmissionInMiddle() {
+ overriddenTwiceWithOmissionInMiddleInjected = true;
+ }
+
+ @Inject public void injectTwiceOverriddenWithOmissionInSubclass() {
+ overriddenTwiceWithOmissionInSubclassInjected = true;
+ }
+}
diff --git a/tck/org/atinject/tck/auto/Seat.java b/tck/org/atinject/tck/auto/Seat.java
new file mode 100644
index 0000000..4d41a20
--- /dev/null
+++ b/tck/org/atinject/tck/auto/Seat.java
@@ -0,0 +1,37 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck.auto;
+
+import org.atinject.tck.auto.accessories.Cupholder;
+
+import javax.inject.Inject;
+import javax.inject.Singleton;
+
+@Singleton
+public class Seat {
+
+ private final Cupholder cupholder;
+
+ @Inject
+ Seat(Cupholder cupholder) {
+ this.cupholder = cupholder;
+ }
+
+ public Cupholder getCupholder() {
+ return cupholder;
+ }
+}
diff --git a/tck/org/atinject/tck/auto/Seatbelt.java b/tck/org/atinject/tck/auto/Seatbelt.java
new file mode 100644
index 0000000..c6329dd
--- /dev/null
+++ b/tck/org/atinject/tck/auto/Seatbelt.java
@@ -0,0 +1,20 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck.auto;
+
+public class Seatbelt {
+}
diff --git a/tck/org/atinject/tck/auto/Tire.java b/tck/org/atinject/tck/auto/Tire.java
new file mode 100644
index 0000000..1a8423f
--- /dev/null
+++ b/tck/org/atinject/tck/auto/Tire.java
@@ -0,0 +1,182 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck.auto;
+
+import org.atinject.tck.auto.accessories.SpareTire;
+import org.atinject.tck.auto.accessories.RoundThing;
+
+import javax.inject.Inject;
+import java.util.LinkedHashSet;
+import java.util.Set;
+
+public class Tire extends RoundThing {
+
+ protected static final FuelTank NEVER_INJECTED = new FuelTank();
+
+ protected static final Set<String> moreProblems = new LinkedHashSet<String>();
+
+ FuelTank constructorInjection = NEVER_INJECTED;
+ @Inject FuelTank fieldInjection = NEVER_INJECTED;
+ FuelTank methodInjection = NEVER_INJECTED;
+ @Inject static FuelTank staticFieldInjection = NEVER_INJECTED;
+ static FuelTank staticMethodInjection = NEVER_INJECTED;
+
+ boolean constructorInjected;
+
+ protected boolean superPrivateMethodInjected;
+ protected boolean superPackagePrivateMethodInjected;
+ protected boolean superProtectedMethodInjected;
+ protected boolean superPublicMethodInjected;
+ protected boolean subPrivateMethodInjected;
+ protected boolean subPackagePrivateMethodInjected;
+ protected boolean subProtectedMethodInjected;
+ protected boolean subPublicMethodInjected;
+
+ protected boolean superPrivateMethodForOverrideInjected;
+ protected boolean superPackagePrivateMethodForOverrideInjected;
+ protected boolean subPrivateMethodForOverrideInjected;
+ protected boolean subPackagePrivateMethodForOverrideInjected;
+ protected boolean protectedMethodForOverrideInjected;
+ protected boolean publicMethodForOverrideInjected;
+
+ public boolean methodInjectedBeforeFields;
+ public boolean subtypeFieldInjectedBeforeSupertypeMethods;
+ public boolean subtypeMethodInjectedBeforeSupertypeMethods;
+ public static boolean staticMethodInjectedBeforeStaticFields;
+ public static boolean subtypeStaticFieldInjectedBeforeSupertypeStaticMethods;
+ public static boolean subtypeStaticMethodInjectedBeforeSupertypeStaticMethods;
+ public boolean similarPrivateMethodInjectedTwice;
+ public boolean similarPackagePrivateMethodInjectedTwice;
+ public boolean overriddenProtectedMethodInjectedTwice;
+ public boolean overriddenPublicMethodInjectedTwice;
+
+ @Inject public Tire(FuelTank constructorInjection) {
+ this.constructorInjection = constructorInjection;
+ }
+
+ @Inject void supertypeMethodInjection(FuelTank methodInjection) {
+ if (!hasTireBeenFieldInjected()) {
+ methodInjectedBeforeFields = true;
+ }
+ if (hasSpareTireBeenFieldInjected()) {
+ subtypeFieldInjectedBeforeSupertypeMethods = true;
+ }
+ if (hasSpareTireBeenMethodInjected()) {
+ subtypeMethodInjectedBeforeSupertypeMethods = true;
+ }
+ this.methodInjection = methodInjection;
+ }
+
+ @Inject static void supertypeStaticMethodInjection(FuelTank methodInjection) {
+ if (!Tire.hasBeenStaticFieldInjected()) {
+ staticMethodInjectedBeforeStaticFields = true;
+ }
+ if (SpareTire.hasBeenStaticFieldInjected()) {
+ subtypeStaticFieldInjectedBeforeSupertypeStaticMethods = true;
+ }
+ if (SpareTire.hasBeenStaticMethodInjected()) {
+ subtypeStaticMethodInjectedBeforeSupertypeStaticMethods = true;
+ }
+ staticMethodInjection = methodInjection;
+ }
+
+ @Inject private void injectPrivateMethod() {
+ if (superPrivateMethodInjected) {
+ similarPrivateMethodInjectedTwice = true;
+ }
+ superPrivateMethodInjected = true;
+ }
+
+ @Inject void injectPackagePrivateMethod() {
+ if (superPackagePrivateMethodInjected) {
+ similarPackagePrivateMethodInjectedTwice = true;
+ }
+ superPackagePrivateMethodInjected = true;
+ }
+
+ @Inject protected void injectProtectedMethod() {
+ if (superProtectedMethodInjected) {
+ overriddenProtectedMethodInjectedTwice = true;
+ }
+ superProtectedMethodInjected = true;
+ }
+
+ @Inject public void injectPublicMethod() {
+ if (superPublicMethodInjected) {
+ overriddenPublicMethodInjectedTwice = true;
+ }
+ superPublicMethodInjected = true;
+ }
+
+ @Inject private void injectPrivateMethodForOverride() {
+ subPrivateMethodForOverrideInjected = true;
+ }
+
+ @Inject void injectPackagePrivateMethodForOverride() {
+ subPackagePrivateMethodForOverrideInjected = true;
+ }
+
+ @Inject protected void injectProtectedMethodForOverride() {
+ protectedMethodForOverrideInjected = true;
+ }
+
+ @Inject public void injectPublicMethodForOverride() {
+ publicMethodForOverrideInjected = true;
+ }
+
+ protected final boolean hasTireBeenFieldInjected() {
+ return fieldInjection != NEVER_INJECTED;
+ }
+
+ protected boolean hasSpareTireBeenFieldInjected() {
+ return false;
+ }
+
+ protected final boolean hasTireBeenMethodInjected() {
+ return methodInjection != NEVER_INJECTED;
+ }
+
+ protected static boolean hasBeenStaticFieldInjected() {
+ return staticFieldInjection != NEVER_INJECTED;
+ }
+
+ protected static boolean hasBeenStaticMethodInjected() {
+ return staticMethodInjection != NEVER_INJECTED;
+ }
+
+ protected boolean hasSpareTireBeenMethodInjected() {
+ return false;
+ }
+
+ boolean packagePrivateMethod2Injected;
+
+ @Inject void injectPackagePrivateMethod2() {
+ packagePrivateMethod2Injected = true;
+ }
+
+ public boolean packagePrivateMethod3Injected;
+
+ @Inject void injectPackagePrivateMethod3() {
+ packagePrivateMethod3Injected = true;
+ }
+
+ public boolean packagePrivateMethod4Injected;
+
+ void injectPackagePrivateMethod4() {
+ packagePrivateMethod4Injected = true;
+ }
+}
diff --git a/tck/org/atinject/tck/auto/V8Engine.java b/tck/org/atinject/tck/auto/V8Engine.java
new file mode 100644
index 0000000..2dc7473
--- /dev/null
+++ b/tck/org/atinject/tck/auto/V8Engine.java
@@ -0,0 +1,61 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck.auto;
+
+import org.atinject.tck.auto.accessories.SpareTire;
+
+import javax.inject.Inject;
+import javax.inject.Named;
+
+public class V8Engine extends GasEngine {
+
+ public V8Engine() {
+ publicNoArgsConstructorInjected = true;
+ }
+
+ @Inject void injectPackagePrivateMethod() {
+ if (subPackagePrivateMethodInjected) {
+ overriddenPackagePrivateMethodInjectedTwice = true;
+ }
+ subPackagePrivateMethodInjected = true;
+ }
+
+ /**
+ * Qualifiers are swapped from how they appear in the superclass.
+ */
+ public void injectQualifiers(Seat seatA, @Drivers Seat seatB,
+ Tire tireA, @Named("spare") Tire tireB) {
+ if ((seatA instanceof DriversSeat)
+ || !(seatB instanceof DriversSeat)
+ || (tireA instanceof SpareTire)
+ || !(tireB instanceof SpareTire)) {
+ qualifiersInheritedFromOverriddenMethod = true;
+ }
+ }
+
+ void injectPackagePrivateMethodForOverride() {
+ subPackagePrivateMethodForOverrideInjected = true;
+ }
+
+ @Inject public void injectTwiceOverriddenWithOmissionInMiddle() {
+ overriddenTwiceWithOmissionInMiddleInjected = true;
+ }
+
+ public void injectTwiceOverriddenWithOmissionInSubclass() {
+ overriddenTwiceWithOmissionInSubclassInjected = true;
+ }
+}
diff --git a/tck/org/atinject/tck/auto/accessories/Cupholder.java b/tck/org/atinject/tck/auto/accessories/Cupholder.java
new file mode 100644
index 0000000..fec70a4
--- /dev/null
+++ b/tck/org/atinject/tck/auto/accessories/Cupholder.java
@@ -0,0 +1,34 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck.auto.accessories;
+
+import org.atinject.tck.auto.Seat;
+
+import javax.inject.Inject;
+import javax.inject.Provider;
+import javax.inject.Singleton;
+
+@Singleton
+public class Cupholder {
+
+ public final Provider<Seat> seatProvider;
+
+ @Inject
+ public Cupholder(Provider<Seat> seatProvider) {
+ this.seatProvider = seatProvider;
+ }
+}
diff --git a/tck/org/atinject/tck/auto/accessories/RoundThing.java b/tck/org/atinject/tck/auto/accessories/RoundThing.java
new file mode 100644
index 0000000..582979c
--- /dev/null
+++ b/tck/org/atinject/tck/auto/accessories/RoundThing.java
@@ -0,0 +1,40 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck.auto.accessories;
+
+import javax.inject.Inject;
+
+public class RoundThing {
+
+ public boolean packagePrivateMethod2Injected;
+
+ @Inject void injectPackagePrivateMethod2() {
+ packagePrivateMethod2Injected = true;
+ }
+
+ public boolean packagePrivateMethod3Injected;
+
+ @Inject void injectPackagePrivateMethod3() {
+ packagePrivateMethod3Injected = true;
+ }
+
+ public boolean packagePrivateMethod4Injected;
+
+ @Inject void injectPackagePrivateMethod4() {
+ packagePrivateMethod4Injected = true;
+ }
+}
diff --git a/tck/org/atinject/tck/auto/accessories/SpareTire.java b/tck/org/atinject/tck/auto/accessories/SpareTire.java
new file mode 100644
index 0000000..5dd6211
--- /dev/null
+++ b/tck/org/atinject/tck/auto/accessories/SpareTire.java
@@ -0,0 +1,122 @@
+/*
+ * Copyright (C) 2009 The JSR-330 Expert Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.atinject.tck.auto.accessories;
+
+import org.atinject.tck.auto.FuelTank;
+import org.atinject.tck.auto.Tire;
+
+import javax.inject.Inject;
+
+public class SpareTire extends Tire {
+
+ FuelTank constructorInjection = NEVER_INJECTED;
+ @Inject FuelTank fieldInjection = NEVER_INJECTED;
+ FuelTank methodInjection = NEVER_INJECTED;
+ @Inject static FuelTank staticFieldInjection = NEVER_INJECTED;
+ static FuelTank staticMethodInjection = NEVER_INJECTED;
+
+ @Inject public SpareTire(FuelTank forSupertype, FuelTank forSubtype) {
+ super(forSupertype);
+ this.constructorInjection = forSubtype;
+ }
+
+ @Inject void subtypeMethodInjection(FuelTank methodInjection) {
+ if (!hasSpareTireBeenFieldInjected()) {
+ methodInjectedBeforeFields = true;
+ }
+ this.methodInjection = methodInjection;
+ }
+
+ @Inject static void subtypeStaticMethodInjection(FuelTank methodInjection) {
+ if (!hasBeenStaticFieldInjected()) {
+ staticMethodInjectedBeforeStaticFields = true;
+ }
+ staticMethodInjection = methodInjection;
+ }
+
+ @Inject private void injectPrivateMethod() {
+ if (subPrivateMethodInjected) {
+ similarPrivateMethodInjectedTwice = true;
+ }
+ subPrivateMethodInjected = true;
+ }
+
+ @Inject void injectPackagePrivateMethod() {
+ if (subPackagePrivateMethodInjected) {
+ similarPackagePrivateMethodInjectedTwice = true;
+ }
+ subPackagePrivateMethodInjected = true;
+ }
+
+ @Inject protected void injectProtectedMethod() {
+ if (subProtectedMethodInjected) {
+ overriddenProtectedMethodInjectedTwice = true;
+ }
+ subProtectedMethodInjected = true;
+ }
+
+ @Inject public void injectPublicMethod() {
+ if (subPublicMethodInjected) {
+ overriddenPublicMethodInjectedTwice = true;
+ }
+ subPublicMethodInjected = true;
+ }
+
+ private void injectPrivateMethodForOverride() {
+ superPrivateMethodForOverrideInjected = true;
+ }
+
+ void injectPackagePrivateMethodForOverride() {
+ superPackagePrivateMethodForOverrideInjected = true;
+ }
+
+ protected void injectProtectedMethodForOverride() {
+ protectedMethodForOverrideInjected = true;
+ }
+
+ public void injectPublicMethodForOverride() {
+ publicMethodForOverrideInjected = true;
+ }
+
+ public boolean hasSpareTireBeenFieldInjected() {
+ return fieldInjection != NEVER_INJECTED;
+ }
+
+ public boolean hasSpareTireBeenMethodInjected() {
+ return methodInjection != NEVER_INJECTED;
+ }
+
+ public static boolean hasBeenStaticFieldInjected() {
+ return staticFieldInjection != NEVER_INJECTED;
+ }
+
+ public static boolean hasBeenStaticMethodInjected() {
+ return staticMethodInjection != NEVER_INJECTED;
+ }
+
+ public boolean packagePrivateMethod2Injected;
+
+ @Inject void injectPackagePrivateMethod2() {
+ packagePrivateMethod2Injected = true;
+ }
+
+ public boolean packagePrivateMethod3Injected;
+
+ void injectPackagePrivateMethod3() {
+ packagePrivateMethod3Injected = true;
+ }
+}
diff --git a/tck/org/atinject/tck/package-info.java b/tck/org/atinject/tck/package-info.java
new file mode 100644
index 0000000..fa72b16
--- /dev/null
+++ b/tck/org/atinject/tck/package-info.java
@@ -0,0 +1,8 @@
+/**
+ * The compatibility test suite for
+ * <a href="http://code.google.com/p/atinject/">JSR-330: Dependency Injection
+ * for Java</a>.
+ *
+ * @see org.atinject.tck.Tck
+ */
+package org.atinject.tck;
diff --git a/tck/tck.iml b/tck/tck.iml
new file mode 100644
index 0000000..b566c3d
--- /dev/null
+++ b/tck/tck.iml
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module relativePaths="true" type="JAVA_MODULE" version="4">
+ <component name="NewModuleRootManager" inherit-compiler-output="true">
+ <exclude-output />
+ <content url="file://$MODULE_DIR$">
+ <sourceFolder url="file://$MODULE_DIR$" isTestSource="false" />
+ </content>
+ <orderEntry type="inheritedJdk" />
+ <orderEntry type="sourceFolder" forTests="false" />
+ <orderEntry type="module" module-name="atinject" />
+ <orderEntry type="library" name="Guice" level="project" />
+ <orderEntry type="module-library">
+ <library>
+ <CLASSES>
+ <root url="jar://$MODULE_DIR$/../lib/junit.jar!/" />
+ </CLASSES>
+ <JAVADOC />
+ <SOURCES>
+ <root url="jar://$MODULE_DIR$/../lib/junit-src.jar!/" />
+ </SOURCES>
+ </library>
+ </orderEntry>
+ </component>
+</module>
+
