com.sun.xml.ws.api.server
Interface SDDocumentFilter


public interface SDDocumentFilter

Provides a way to filter SDDocument infoset while writing it. These filter objects can be added to ServiceDefinition using ServiceDefinition.addFilter(SDDocumentFilter)


Method Summary
 javax.xml.stream.XMLStreamWriter filter(SDDocument doc, javax.xml.stream.XMLStreamWriter w)
          Returns a wrapped XMLStreamWriter on top of passed-in XMLStreamWriter.
 

Method Detail

filter

javax.xml.stream.XMLStreamWriter filter(SDDocument doc,
                                        javax.xml.stream.XMLStreamWriter w)
                                        throws javax.xml.stream.XMLStreamException,
                                               IOException
Returns a wrapped XMLStreamWriter on top of passed-in XMLStreamWriter. It works like any filtering API for e.g. FilterOutputStream. The method returns a XMLStreamWriter that calls the same methods on original XMLStreamWriter with some modified events. The end result is some infoset is filtered before it reaches the original writer and the infoset writer doesn't have to change any code to incorporate this filter.

Parameters:
doc - gives context for the filter. This should only be used to query read-only information. Calling doc.writeTo() may result in infinite loop.
w - Original XMLStreamWriter
Returns:
Filtering XMLStreamWriter
Throws:
javax.xml.stream.XMLStreamException
IOException