diff options
Diffstat (limited to 'site/branches/site-20060730-mvnbased/src/site/resources/javadoc/tuscany-core/org/apache/tuscany/core/wire/WireFactory.html')
| -rw-r--r-- | site/branches/site-20060730-mvnbased/src/site/resources/javadoc/tuscany-core/org/apache/tuscany/core/wire/WireFactory.html | 348 |
1 files changed, 348 insertions, 0 deletions
diff --git a/site/branches/site-20060730-mvnbased/src/site/resources/javadoc/tuscany-core/org/apache/tuscany/core/wire/WireFactory.html b/site/branches/site-20060730-mvnbased/src/site/resources/javadoc/tuscany-core/org/apache/tuscany/core/wire/WireFactory.html new file mode 100644 index 0000000000..f63e99e723 --- /dev/null +++ b/site/branches/site-20060730-mvnbased/src/site/resources/javadoc/tuscany-core/org/apache/tuscany/core/wire/WireFactory.html @@ -0,0 +1,348 @@ +<!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_06) on Mon May 15 07:33:02 EDT 2006 -->
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<TITLE>
+WireFactory (Tuscany Core incubating-M1 API)
+</TITLE>
+
+<META NAME="keywords" CONTENT="org.apache.tuscany.core.wire.WireFactory interface">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="WireFactory (Tuscany Core incubating-M1 API)";
+}
+</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="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="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="class-use/WireFactory.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </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>
+Tuscany Core</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../../org/apache/tuscany/core/wire/WireException.html" title="class in org.apache.tuscany.core.wire"><B>PREV CLASS</B></A>
+ <A HREF="../../../../../org/apache/tuscany/core/wire/WireFactoryFactory.html" title="interface in org.apache.tuscany.core.wire"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../../index.html?org/apache/tuscany/core/wire/WireFactory.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="WireFactory.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">
+org.apache.tuscany.core.wire</FONT>
+<BR>
+Interface WireFactory<T></H2>
+<DL>
+<DT><B>All Known Subinterfaces:</B> <DD><A HREF="../../../../../org/apache/tuscany/core/wire/SourceWireFactory.html" title="interface in org.apache.tuscany.core.wire">SourceWireFactory</A><T>, <A HREF="../../../../../org/apache/tuscany/core/wire/TargetWireFactory.html" title="interface in org.apache.tuscany.core.wire">TargetWireFactory</A><T></DD>
+</DL>
+<DL>
+<DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../../../org/apache/tuscany/core/wire/jdk/JDKSourceWireFactory.html" title="class in org.apache.tuscany.core.wire.jdk">JDKSourceWireFactory</A>, <A HREF="../../../../../org/apache/tuscany/core/wire/jdk/JDKTargetWireFactory.html" title="class in org.apache.tuscany.core.wire.jdk">JDKTargetWireFactory</A>, <A HREF="../../../../../org/apache/tuscany/core/wire/impl/NullWireFactory.html" title="class in org.apache.tuscany.core.wire.impl">NullWireFactory</A></DD>
+</DL>
+<HR>
+<DL>
+<DT><PRE>public interface <B>WireFactory<T></B></DL>
+</PRE>
+
+<P>
+Implementations are responsible for managing source or target sides of a wire, including creation of service proxies. + Source-side wires are injected on references and may contain policy interceptors and/or handlers specified by them. Target-side + wires may contain policy interceptors and/or handlers specified by the service the wire is targeted to or one of its + operations. Source- and target-side <code>WireFactory</code>s are held in the <A HREF="../../../../../org/apache/tuscany/core/builder/ContextFactory.html" title="interface in org.apache.tuscany.core.builder"><CODE>ContextFactory</CODE></A> + associated with the source reference or target service. + <p/> + When an assembly is built by the runtime, source-side and target-side wires are "bridged" on the source side (i.e. a reference + to the target-side is stored in the source-side). This bridging process is done by a series of <A HREF="../../../../../org/apache/tuscany/core/builder/WireBuilder.html" title="interface in org.apache.tuscany.core.builder"><CODE>WireBuilder</CODE></A>s configured in the runtime. When a new component implementation instance is + created, it will be injected with a proxy for each reference containing the bridged source- and target-side wires. + <p/> + Unmanaged code, i.e. clients that are not components, that perform a locate operation are handled differently. In this case, a + target-side proxy will be returned by the locate operation created by the <code>WireFactory</code> associated with the target + service. This target-side proxy will only contain the target-side wire and its handlers/interceptors.Ê + <p/> + Wires are structured by operation; that is, they contain an invocation chain per operation on a service. Note that the service + specified by a reference may differ in type from the target service specified by the wire. In this case, a mediation may be + performed by the runtime. Hence, source-to-target bridging is done on a per operation basis. Source- and target-side Invocation + chains are accessible through the subtypes of <code>WireFactory</code>.
+<P>
+
+<P>
+<DL>
+<DT><B>Version:</B></DT>
+ <DD>$Rev: 396284 $ $Date: 2006-04-23 11:27:42 -0400 (Sun, 23 Apr 2006) $</DD>
+</DL>
+<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> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../org/apache/tuscany/core/wire/WireFactory.html#addInterface(java.lang.Class)">addInterface</A></B>(java.lang.Class claz)</CODE>
+
+<BR>
+ Adds an interface type generated proxies implement</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> <A HREF="../../../../../org/apache/tuscany/core/wire/WireFactory.html" title="type parameter in WireFactory">T</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../org/apache/tuscany/core/wire/WireFactory.html#createProxy()">createProxy</A></B>()</CODE>
+
+<BR>
+ Returns a proxy for a service specified by a reference or target</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.lang.Class</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../org/apache/tuscany/core/wire/WireFactory.html#getBusinessInterface()">getBusinessInterface</A></B>()</CODE>
+
+<BR>
+ Returns the primary interface type implemented by generated proxies</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> java.lang.Class[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../org/apache/tuscany/core/wire/WireFactory.html#getImplementatedInterfaces()">getImplementatedInterfaces</A></B>()</CODE>
+
+<BR>
+ Returns an array of all interfaces implemented by generated proxies</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../org/apache/tuscany/core/wire/WireFactory.html#initialize()">initialize</A></B>()</CODE>
+
+<BR>
+ Prepares the factory.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE> void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../../org/apache/tuscany/core/wire/WireFactory.html#setBusinessInterface(java.lang.Class)">setBusinessInterface</A></B>(java.lang.Class interfaze)</CODE>
+
+<BR>
+ Sets the primary interface type generated proxies implement</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="initialize()"><!-- --></A><H3>
+initialize</H3>
+<PRE>
+void <B>initialize</B>()
+ throws <A HREF="../../../../../org/apache/tuscany/core/wire/WireFactoryInitException.html" title="class in org.apache.tuscany.core.wire">WireFactoryInitException</A></PRE>
+<DL>
+<DD>Prepares the factory. This will typically be called at buildSource time, after bridging source- and target-side invocation chains.
+<P>
+<DD><DL>
+
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../../../org/apache/tuscany/core/wire/WireFactoryInitException.html" title="class in org.apache.tuscany.core.wire">WireFactoryInitException</A></CODE> - if an error is encountered during initialization</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="createProxy()"><!-- --></A><H3>
+createProxy</H3>
+<PRE>
+<A HREF="../../../../../org/apache/tuscany/core/wire/WireFactory.html" title="type parameter in WireFactory">T</A> <B>createProxy</B>()
+ throws <A HREF="../../../../../org/apache/tuscany/core/wire/ProxyCreationException.html" title="class in org.apache.tuscany.core.wire">ProxyCreationException</A></PRE>
+<DL>
+<DD>Returns a proxy for a service specified by a reference or target
+<P>
+<DD><DL>
+
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../../../org/apache/tuscany/core/wire/ProxyCreationException.html" title="class in org.apache.tuscany.core.wire">ProxyCreationException</A></CODE></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="setBusinessInterface(java.lang.Class)"><!-- --></A><H3>
+setBusinessInterface</H3>
+<PRE>
+void <B>setBusinessInterface</B>(java.lang.Class interfaze)</PRE>
+<DL>
+<DD>Sets the primary interface type generated proxies implement
+<P>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getBusinessInterface()"><!-- --></A><H3>
+getBusinessInterface</H3>
+<PRE>
+java.lang.Class <B>getBusinessInterface</B>()</PRE>
+<DL>
+<DD>Returns the primary interface type implemented by generated proxies
+<P>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="addInterface(java.lang.Class)"><!-- --></A><H3>
+addInterface</H3>
+<PRE>
+void <B>addInterface</B>(java.lang.Class claz)</PRE>
+<DL>
+<DD>Adds an interface type generated proxies implement
+<P>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getImplementatedInterfaces()"><!-- --></A><H3>
+getImplementatedInterfaces</H3>
+<PRE>
+java.lang.Class[] <B>getImplementatedInterfaces</B>()</PRE>
+<DL>
+<DD>Returns an array of all interfaces implemented by generated proxies
+<P>
+<DD><DL>
+</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="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="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="class-use/WireFactory.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </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>
+Tuscany Core</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../../org/apache/tuscany/core/wire/WireException.html" title="class in org.apache.tuscany.core.wire"><B>PREV CLASS</B></A>
+ <A HREF="../../../../../org/apache/tuscany/core/wire/WireFactoryFactory.html" title="interface in org.apache.tuscany.core.wire"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../../index.html?org/apache/tuscany/core/wire/WireFactory.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="WireFactory.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>
+-
+</BODY>
+</HTML>
|