| com.sun.xml.ws.api.pipe |
| com.sun.xml.ws.api.pipe.Pipe and related abstractions. |
| Java Source File Name | Type | Comment |
| ClientPipeAssemblerContext.java | Class | Factory for well-known
Pipe implementations
that the
PipelineAssembler needs to use
to satisfy JAX-WS requirements. |
| ClientTubeAssemblerContext.java | Class | Factory for well-known
Tube implementations
that the
TubelineAssembler needs to use
to satisfy JAX-WS requirements. |
| Codec.java | Interface | Encodes a
Message (its XML infoset and attachments) to a sequence of bytes.
This interface provides pluggability for different ways of encoding XML infoset,
such as plain XML (plus MIME attachments), XOP, and FastInfoset.
Transport usually needs a MIME content type of the encoding, so the
Codec interface is designed to return this information. |
| Codecs.java | Class | Factory methods for some of the
Codec implementations. |
| ContentType.java | Interface | A Content-Type transport header that will be returned by
Codec.encode(com.sun.xml.ws.api.message.Packetjava.io.OutputStream) . |
| Engine.java | Class | Collection of
Fiber s. |
| Fiber.java | Class | User-level thread. Represents the execution of one request/response processing.
JAX-WS RI is capable of running a large number of request/response concurrently by
using a relatively small number of threads. |
| FiberContextSwitchInterceptor.java | Interface | Interception for
Fiber context switch.
Even though pipeline runs asynchronously, sometimes it's desirable
to bind some state to the current thread running a fiber. |
| NextAction.java | Class | Indicates what shall happen after
Tube.processRequest(Packet) or
Tube.processResponse(Packet) returns. |
| package-info.java | | |
| Pipe.java | Interface | Abstraction of the intermediate layers in the processing chain
and transport.
What is a
Pipe ?
Transport is a kind of pipe. |
| PipeCloner.java | Class | Clones the whole pipeline.
Since
Pipe s may form an arbitrary directed graph, someone needs
to keep track of isomorphism for a clone to happen correctly. |
| PipelineAssembler.java | Interface | Creates a pipeline. |
| PipelineAssemblerFactory.java | Class | Creates
PipelineAssembler .
To create a pipeline,
the JAX-WS runtime locates
PipelineAssemblerFactory s through
the META-INF/services/com.sun.xml.ws.api.pipe.PipelineAssemblerFactory files.
Factories found are checked to see if it supports the given binding ID one by one,
and the first valid
PipelineAssembler returned will be used to create
a pipeline.
TODO: is bindingId really extensible? for this to be extensible,
someone seems to need to hook into WSDL parsing.
TODO: JAX-WSA might not define its own binding ID -- it may just go to an extension element
of WSDL. |
| ServerPipeAssemblerContext.java | Class | Factory for well-known server
Pipe implementations
that the
PipelineAssembler needs to use
to satisfy JAX-WS requirements. |
| ServerTubeAssemblerContext.java | Class | Factory for well-known server
Tube implementations
that the
TubelineAssembler needs to use
to satisfy JAX-WS requirements. |
| SOAPBindingCodec.java | Interface | |
| StreamSOAPCodec.java | Interface | Reads events from
XMLStreamReader and constructs a
Message for SOAP envelope. |
| Stubs.java | Class | Factory methods of various stubs.
This class provides various methods to create "stub"s,
which are the component that turns a method invocation
into a
Message and back into a return value.
This class is meant to serve as the API from JAX-WS to
Tango, so that they don't have hard-code dependency on
our implementation classes.
Common Parameters and Their Meanings
Pipe next
Stubs turn a method invocation into a
Pipe.process(com.sun.xml.ws.api.message.Packet) invocation,
and this pipe passed in as the next parameter will receive a
Message from newly created stub.
BindingImpl binding
Stubs implement
BindingProvider , and its
BindingProvider.getBinding will return this binding object. |
| TransportPipeFactory.java | Class | Factory for transport pipes that enables transport pluggability. |
| TransportTubeFactory.java | Class | Factory for transport tubes that enables transport pluggability. |
| Tube.java | Interface | Abstraction of the intermediate layers in the processing chain
and transport.
What is a
Tube ?
Tube is a basic processing unit that represents SOAP-level
protocol handling code. |
| TubeCloner.java | Class | Clones the whole pipeline.
Since
Tube s may form an arbitrary directed graph, someone needs
to keep track of isomorphism for a clone to happen correctly. |
| TubelineAssembler.java | Interface | Creates a tubeline. |
| TubelineAssemblerFactory.java | Class | Creates
TubelineAssembler . |