POXNET Wiki & Documentation Rss Feed

UPDATED WIKI: Home

gblock — Mon, 09 Apr 2007 07:23:25 GMT

Project Description
POX.NET is a set of utility classes that assist in creating POX (Plain Old Xml) services and clients in .NET 2.0. This libary leverages classes within .NET 2.0 and does not require any additional add-ons. With POX.NET working with POX in .NET is a breeze.

For background of this project see the original blog post at http://blogs.msdn.com/gblock/archive/2007/01/22/pox-xmlhttp-in-net-2-0.aspx.

Sample POX Client / Service and test fixture are included in the source.

Mini QuickStart - Using POX.NET

POX.NET allows you to do two main things. 1. Create a POX client to invoke a POX service. 2. Create an ASP.NET POX service.

Invoking a POX service.

In order to invoke a POX Service using POX.NET you do 3 things:

Create a POXClient instance
Invoke the Post<T> method passing an Xml serializable object instance.
Call GetResponse<T> and retrieve the response type.

The example below shows how to Invoke a POX service that accepts an Order object as part of the request, and retrieves an OrderResponse object as part of the response.

using Microsoft.POXUtils
 
public OrderResponse SubmitOrder(Order order)
{
    Order Order = new Order(1234);
    POXClient Client = new POXClient("http://Orders/SubmitOrder.aspx");
    Client.Post(order);
    return Client.GetResponse<OrderResponse>();
}

Creating a POX Service

To create a POX service, follow the following steps:

Add a new ASPX page in your web application which represents you service i.e. OrderService.aspx.
Change the base class to inherit from POXPage.
In the Page_Load event handler, call the GetRequest<T> method to retrieve the request object that the service has been passed as part of the invocation.
Create your response object and call the WriteResponse<T> method.

The example shows how to create a POX service that receives the Order object posted in the client example, and returns an OrderResponse.

using Microsoft.POXUtils
 
class OrderService : POXPage {
 
    protected void Page_Load(object sender, EventArgs e)
    {
        Order CurrentOrder = GetRequest<Order>();
        if (CurrentOrder != null)
        {
            OrderResponse OrderResponse = new OrderResponse(CurrentOrder, "confirmed", "1000");
            WriteResponse(OrderResponse);
        }
    }
}

What's included in the package?

Microsoft.POXUtils

Microsoft.POXUtils.Client

Provides a class which enscapsualtes a POX service invocation. The class exposes methods for posting and retreving Xml Serializable objects, streams and Xml Documents via a POX Service.

public void Post<T>(T objectToPost) - Serializes objectToPost and then posts the stream to a POX service.
public void PostDocument(XmlDocument document) - Posts the contents of an document to a POX service.
public void PostStream(stream documentStream) - Posts a stream to a POX service.
public T GetResponse<T>() - Retrieves the result stream from a POX service an deserializes to an instance of type T.
public XmlDocument GetResponseDocument() - Retrives the result stream from a POX service returns an XmlDocument loaded with that stream.
public MemoryStream GetResponseStream() - Retrieves the result stream from a POX service and loads it into a MemoryStream.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument.

Microsoft.POXUtils.POXPage

Provides an inherited System.Web.UI.Page class that exposes methods for handling a POX web request and response.

public T GetRequest<T>() - Retrieves the request stream and deserializes to an instance of type T.
public XmlDocument GetRequestDocument() - Retrieves the request stream and returns an XmlDocument loaded with that stream.
public void WriteResponse<T>(T objectToWrite) - Serializes objectToWrite and then posts the stream to the response.
public void WriteResponseDocument(XmlDocument document) - Posts the contents of document to the response.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument to the response.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument from the request.

Microsoft.POXUtils.Common

Handles low-level streaming, serialization and deserialization for Client and POXPage.

internal static void WriteStream(Stream inputStream, Stream outputStream, int length) - Copies the contents of inputStream to outputStream.
private static void WriteStream(Stream outputStream, byte[] streamBuffer,int length) - Copies the contents of streamBuffer to outputStream.
internal static MemoryStream ReadStream(Stream inputStream, int length) - Reads the contents of inputStream and returns a new MemoryStream.
internal static MemoryStream SerializeObject<T>(T objectToSerialize, XmlWriterSettings writerSettings) - Serializes objectToSerialize to a MemoryStream using the provided settings.
internal static T DeserializeObject<T>(Stream inputStream, XmlReaderSettings readerSettings) - Deserializes inputStream to an instance of type T using the provided settings.
internal static XmlDocument GetDocumentFromStream(Stream stream, XmlReaderSettings readerSettings) - Loads the contents of stream into an XmlDocument using the provided settings.
internal static MemoryStream GetStreamFromDocument(XmlDocument document, XmlWriterSettings writerSettings) - Writes the contents of document to a stream using the provided settings.

Releases

.1 Alpha - http://www.codeplex.com/POXNET/Release/ProjectReleases.aspx?ReleaseId=2183
.11 Alpha - http://www.codeplex.com/POXNET/Release/ProjectReleases.aspx?ReleaseId=2966

UPDATED WIKI: Home

gblock — Mon, 09 Apr 2007 06:55:39 GMT

Microsoft.POXUtils

Microsoft.POXUtils.Client

Provides a class which enscapsualtes a POX service invocation. The class exposes methods for posting and retreving Xml Serializable objects, streams and Xml Documents via a POX Service.

public void Post<T>(T objectToPost) - Serializes objectToPost and then posts the stream to a POX service.
public void PostDocument(XmlDocument document) - Posts the contents of an document to a POX service.
public void PostStream(stream documentStream) - Posts a stream to a POX service.
public T GetResponse<T>() - Retrieves the result stream from a POX service an deserializes to an instance of type T.
public XmlDocument GetResponseDocument() - Retrives the result stream from a POX service returns an XmlDocument loaded with that stream.
public MemoryStream GetResponseStream() - Retrieves the result stream from a POX service and loads it into a MemoryStream.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument.

Microsoft.POXUtils.POXPage

Provides an inherited System.Web.UI.Page class that exposes methods for handling a POX web request and response.

public T GetRequest<T>() - Retrieves the request stream and deserializes to an instance of type T.
public XmlDocument GetRequestDocument() - Retrieves the request stream and returns an XmlDocument loaded with that stream.
public void WriteResponse<T>(T objectToWrite) - Serializes objectToWrite and then posts the stream to the response.
public void WriteResponseDocument(XmlDocument document) - Posts the contents of document to the response.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument to the response.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument from the request.

Microsoft.POXUtils.Common

Handles low-level streaming, serialization and deserialization for Client and POXPage.

internal static void WriteStream(Stream inputStream, Stream outputStream, int length) - Copies the contents of inputStream to outputStream.
private static void WriteStream(Stream outputStream, byte[] streamBuffer,int length) - Copies the contents of streamBuffer to outputStream.
internal static MemoryStream ReadStream(Stream inputStream, int length) - Reads the contents of inputStream and returns a new MemoryStream.
internal static MemoryStream SerializeObject<T>(T objectToSerialize, XmlWriterSettings writerSettings) - Serializes objectToSerialize to a MemoryStream using the provided settings.
internal static T DeserializeObject<T>(Stream inputStream, XmlReaderSettings readerSettings) - Deserializes inputStream to an instance of type T using the provided settings.
internal static XmlDocument GetDocumentFromStream(Stream stream, XmlReaderSettings readerSettings) - Loads the contents of stream into an XmlDocument using the provided settings.
internal static MemoryStream GetStreamFromDocument(XmlDocument document, XmlWriterSettings writerSettings) - Writes the contents of document to a stream using the provided settings.

Releases

.1 Alpha - http://www.codeplex.com/POXNET/Release/ProjectReleases.aspx?ReleaseId=2183
.11 Alpha - http://www.codeplex.com/POXNET/Release/ProjectReleases.aspx?ReleaseId=2966

UPDATED WIKI: Home

gblock — Sun, 11 Mar 2007 19:49:05 GMT

Microsoft.POXUtils

Microsoft.POXUtils.Client

Provides a class which enscapsualtes a POX service invocation. The class exposes methods for posting and retreving Xml Serializable objects, streams and Xml Documents via a POX Service.

public void Post<T>(T objectToPost) - Serializes objectToPost and then posts the stream to a POX service.
public void PostDocument(XmlDocument document) - Posts the contents of an document to a POX service.
public void PostStream(stream documentStream) - Posts a stream to a POX service.
public T GetResponse<T>() - Retrieves the result stream from a POX service an deserializes to an instance of type T.
public XmlDocument GetResponseDocument() - Retrives the result stream from a POX service returns an XmlDocument loaded with that stream.
public MemoryStream GetResponseStream() - Retrieves the result stream from a POX service and loads it into a MemoryStream.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument.

Microsoft.POXUtils.POXPage

Provides an inherited System.Web.UI.Page class that exposes methods for handling a POX web request and response.

public T GetRequest<T>() - Retrieves the request stream and deserializes to an instance of type T.
public XmlDocument GetRequestDocument() - Retrieves the request stream and returns an XmlDocument loaded with that stream.
public void WriteResponse<T>(T objectToWrite) - Serializes objectToWrite and then posts the stream to the response.
public void WriteResponseDocument(XmlDocument document) - Posts the contents of document to the response.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument to the response.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument from the request.

Microsoft.POXUtils.Common

Handles low-level streaming, serialization and deserialization for Client and POXPage.

internal static void WriteStream(Stream inputStream, Stream outputStream, int length) - Copies the contents of inputStream to outputStream.
private static void WriteStream(Stream outputStream, byte[] streamBuffer,int length) - Copies the contents of streamBuffer to outputStream.
internal static MemoryStream ReadStream(Stream inputStream, int length) - Reads the contents of inputStream and returns a new MemoryStream.
internal static MemoryStream SerializeObject<T>(T objectToSerialize, XmlWriterSettings writerSettings) - Serializes objectToSerialize to a MemoryStream using the provided settings.
internal static T DeserializeObject<T>(Stream inputStream, XmlReaderSettings readerSettings) - Deserializes inputStream to an instance of type T using the provided settings.
internal static XmlDocument GetDocumentFromStream(Stream stream, XmlReaderSettings readerSettings) - Loads the contents of stream into an XmlDocument using the provided settings.
internal static MemoryStream GetStreamFromDocument(XmlDocument document, XmlWriterSettings writerSettings) - Writes the contents of document to a stream using the provided settings.

Releases

.1 Alpha - http://www.codeplex.com/POXNET/Release/ProjectReleases.aspx?ReleaseId=2183

UPDATED WIKI: Home

gblock — Wed, 07 Mar 2007 21:04:12 GMT

Microsoft.POXUtils

Microsoft.POXUtils.Client

Provides a class which enscapsualtes a POX service invocation. The class exposes methods for posting and retreving Xml Serializable objects, streams and Xml Documents via a POX Service.

public void Post<T>(T objectToPost) - Serializes objectToPost and then posts the stream to a POX service.
public void PostDocument(XmlDocument document) - Posts the contents of an document to a POX service.
public void PostStream(stream documentStream) - Posts a stream to a POX service.
public T GetResponse<T>() - Retrieves the result stream from a POX service an deserializes to an instance of type T.
public XmlDocument GetResponseDocument() - Retrives the result stream from a POX service returns an XmlDocument loaded with that stream.
public MemoryStream GetResponseStream() - Retrieves the result stream from a POX service and loads it into a MemoryStream.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument.

Microsoft.POXUtils.POXPage

Provides an inherited System.Web.UI.Page class that exposes methods for handling a POX web request and response.

public T GetRequest<T>() - Retrieves the request stream and deserializes to an instance of type T.
public T GetRequestDocument() - Retrieves the request stream and returns an XmlDocument loaded with that stream.
public void WriteResponse<T>(T objectToWrite) - Serializes objectToWrite and then posts the stream to the response.
public void WriteResponseDocument(XmlDocument document) - Posts the contents of document to the response.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument to the response.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument from the request.

Microsoft.POXUtils.Common

Handles low-level streaming, serialization and deserialization for Client and POXPage.

internal static void WriteStream(Stream inputStream, Stream outputStream, int length) - Copies the contents of inputStream to outputStream.
private static void WriteStream(Stream outputStream, byte[] streamBuffer,int length) - Copies the contents of streamBuffer to outputStream.
internal static MemoryStream ReadStream(Stream inputStream, int length) - Reads the contents of inputStream and returns a new MemoryStream.
internal static MemoryStream SerializeObject<T>(T objectToSerialize, XmlWriterSettings writerSettings) - Serializes objectToSerialize to a MemoryStream using the provided settings.
internal static T DeserializeObject<T>(Stream inputStream, XmlReaderSettings readerSettings) - Deserializes inputStream to an instance of type T using the provided settings.
internal static XmlDocument GetDocumentFromStream(Stream stream, XmlReaderSettings readerSettings) - Loads the contents of stream into an XmlDocument using the provided settings.
internal static MemoryStream GetStreamFromDocument(XmlDocument document, XmlWriterSettings writerSettings) - Writes the contents of document to a stream using the provided settings.

Releases

.1 Alpha - http://www.codeplex.com/POXNET/Release/ProjectReleases.aspx?ReleaseId=2183

UPDATED WIKI: Home

gblock — Wed, 07 Mar 2007 21:01:56 GMT

Microsoft.POXUtils

Microsoft.POXUtils.Client

Provides methods for posting and retreving XML Serializable objects, streams and XML Documents to a POX Service.

public void Post<T>(T objectToPost) - Serializes objectToPost and then posts the stream to a POX service.
public void PostDocument(XmlDocument document) - Posts the contents of an document to a POX service.
public void PostStream(stream documentStream) - Posts a stream to a POX service.
public T GetResponse<T>() - Retrieves the result stream from a POX service an deserializes to an instance of type T.
public XmlDocument GetResponseDocument() - Retrives the result stream from a POX service returns an XmlDocument loaded with that stream.
public MemoryStream GetResponseStream() - Retrieves the result stream from a POX service and loads it into a MemoryStream.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument.

Microsoft.POXUtils.POXPage

Provides an inherited System.Web.UI.Page class that exposes methods for handling a POX web request and response.

public T GetRequest<T>() - Retrieves the request stream and deserializes to an instance of type T.
public T GetRequestDocument() - Retrieves the request stream and returns an XmlDocument loaded with that stream.
public void WriteResponse<T>(T objectToWrite) - Serializes objectToWrite and then posts the stream to the response.
public void WriteResponseDocument(XmlDocument document) - Posts the contents of document to the response.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument to the response.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument from the request.

Microsoft.POXUtils.Common

Handles low-level streaming, serialization and deserialization for Client and POXPage.

internal static void WriteStream(Stream inputStream, Stream outputStream, int length) - Copies the contents of inputStream to outputStream.
private static void WriteStream(Stream outputStream, byte[] streamBuffer,int length) - Copies the contents of streamBuffer to outputStream.
internal static MemoryStream ReadStream(Stream inputStream, int length) - Reads the contents of inputStream and returns a new MemoryStream.
internal static MemoryStream SerializeObject<T>(T objectToSerialize, XmlWriterSettings writerSettings) - Serializes objectToSerialize to a MemoryStream using the provided settings.
internal static T DeserializeObject<T>(Stream inputStream, XmlReaderSettings readerSettings) - Deserializes inputStream to an instance of type T using the provided settings.
internal static XmlDocument GetDocumentFromStream(Stream stream, XmlReaderSettings readerSettings) - Loads the contents of stream into an XmlDocument using the provided settings.
internal static MemoryStream GetStreamFromDocument(XmlDocument document, XmlWriterSettings writerSettings) - Writes the contents of document to a stream using the provided settings.

Releases

.1 Alpha - http://www.codeplex.com/POXNET/Release/ProjectReleases.aspx?ReleaseId=2183

UPDATED WIKI: Home

gblock — Wed, 07 Mar 2007 19:49:45 GMT

Microsoft.POXUtils

Microsoft.POXUtils.Client

Provides methods for posting and retreving XML Serializable objects, streams and XML Documents to a POX Service.

public void Post<T>(T objectToPost) - Serializes objectToPost and then posts the stream to a POX service.
public void PostDocument(XmlDocument document) - Posts the contents of an document to a POX service.
public void PostStream(stream documentStream) - Posts a stream to a POX service.
public T GetResponse<T>() - Retrieves the result stream from a POX service an deserializes to an instance of type T.
public XmlDocument GetResponseDocument() - Retrives the result stream from a POX service returns an XmlDocument loaded with that stream.
public MemoryStream GetResponseStream() - Retrieves the result stream from a POX service and loads it into a MemoryStream.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument.

Microsoft.POXUtils.POXPage

Provides an inherited System.Web.UI.Page class that exposes methods for handling a POX web request and response.

public T GetRequest<T>() - Retrieves the request stream and deserializes to an instance of type T.
public T GetRequestDocument() - Retrieves the request stream and returns an XmlDocument loaded with that stream.
public void WriteResponse<T>(T objectToWrite) - Serializes objectToWrite and then posts the stream to the response.
public void WriteResponseDocument(XmlDocument document) - Posts the contents of document to the response.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument to the response.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument from the request.

Microsoft.POXUtils.Common

Handles low-level streaming, serialization and deserialization for Client and POXPage.

internal static void WriteStream(Stream inputStream, Stream outputStream, int length) - Copies the contents of inputStream to outputStream.
private static void WriteStream(Stream outputStream, byte[] streamBuffer,int length) - Copies the contents of streamBuffer to outputStream.
internal static MemoryStream ReadStream(Stream inputStream, int length) - Reads the contents of inputStream and returns a new MemoryStream.
internal static MemoryStream SerializeObject<T>(T objectToSerialize, XmlWriterSettings writerSettings) - Serializes objectToSerialize to a MemoryStream using the provided settings.
internal static T DeserializeObject<T>(Stream inputStream, XmlReaderSettings readerSettings) - Deserializes inputStream to an instance of type T using the provided settings.
internal static XmlDocument GetDocumentFromStream(Stream stream, XmlReaderSettings readerSettings) - Loads the contents of stream into an XmlDocument using the provided settings.
internal static MemoryStream GetStreamFromDocument(XmlDocument document, XmlWriterSettings writerSettings) - Writes the contents of document to a stream using the provided settings.

Releases

.1 Alpha - http://www.codeplex.com/POXNET/Release/ProjectReleases.aspx?ReleaseId=2183

UPDATED WIKI: Home

gblock — Wed, 07 Mar 2007 19:28:27 GMT

Microsoft.POXUtils

Microsoft.POXUtils.Client

Provides methods for posting and retreving XML Serializable objects, streams and XML Documents to a POX Service.

public void Post<T>(T objectToPost) - Serializes objectToPost and then posts the stream to a POX service.
public void PostDocument(XmlDocument document) - Posts the contents of an document to a POX service.
public void PostStream(stream documentStream) - Posts a stream to a POX service.
public T GetResponse<T>() - Retrieves the result stream from a POX service an deserializes to an instance of type T.
public XmlDocument GetResponseDocument() - Retrives the result stream from a POX service returns an XmlDocument loaded with that stream.
public MemoryStream GetResponseStream() - Retrieves the result stream from a POX service and loads it into a MemoryStream.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument.

Microsoft.POXUtils.POXPage

Provides an inherited System.Web.UI.Page class that exposes methods for handling a POX web request and response.

public T GetRequest<T>() - Retrieves the request stream and deserializes to an instance of type T.
public T GetRequestDocument() - Retrieves the request stream and returns an XmlDocument loaded with that stream.
public void WriteResponse<T>(T objectToWrite) - Serializes objectToWrite and then posts the stream to the response.
public void WriteResponseDocument(XmlDocument document) - Posts the contents of document to the response.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument to the response.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument from the request.

Microsoft.POXUtils.Common

Handles low-level streaming, serialization and deserialization for Client and POXPage.

internal static void WriteStream(Stream inputStream, Stream outputStream, int length) - Copies the contents of inputStream to outputStream.
private static void WriteStream(Stream outputStream, byte[] streamBuffer,int length) - Copies the contents of streamBuffer to outputStream.
internal static MemoryStream ReadStream(Stream inputStream, int length) - Reads the contents of inputStream and returns a new MemoryStream.
internal static MemoryStream SerializeObject<T>(T objectToSerialize, XmlWriterSettings writerSettings) - Serializes objectToSerialize to a MemoryStream using the provided settings.
internal static T DeserializeObject<T>(Stream inputStream, XmlReaderSettings readerSettings) - Deserializes inputStream to an instance of type T using the provided settings.
internal static XmlDocument GetDocumentFromStream(Stream stream, XmlReaderSettings readerSettings) - Loads the contents of stream into an XmlDocument using the provided settings.
internal static MemoryStream GetStreamFromDocument(XmlDocument document, XmlWriterSettings writerSettings) - Writes the contents of document to a stream using the provided settings.

Releases

.1 Alpha - http://www.codeplex.com/POXNET/Release/ProjectReleases.aspx?ReleaseId=2183

UPDATED WIKI: Home

gblock — Wed, 07 Mar 2007 19:26:15 GMT

Microsoft.POXUtils

Microsoft.POXUtils.Client

Provides methods for posting and retreving XML Serializable objects, streams and XML Documents to a POX Service.

public void Post<T>(T objectToPost) - Serializes objectToPost and then posts the stream to a POX service.
public void PostDocument(XmlDocument document) - Posts the contents of an document to a POX service.
public void PostStream(stream documentStream) - Posts a stream to a POX service.
public T GetResponse<T>() - Retrieves the result stream from a POX service an deserializes to an instance of type T.
public XmlDocument GetResponseDocument() - Retrives the result stream from a POX service returns an XmlDocument loaded with that stream.
public MemoryStream GetResponseStream() - Retrieves the result stream from a POX service and loads it into a MemoryStream.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument.

Microsoft.POXUtils.POXPage

Provides an inherited System.Web.UI.Page class that exposes methods for handling a POX web request and response.

public T GetRequest<T>() - Retrieves the request stream and deserializes to an instance of type T.
public T GetRequestDocument() - Retrieves the request stream and returns an XmlDocument loaded with that stream.
public void WriteResponse<T>(T objectToWrite) - Serializes objectToWrite and then posts the stream to the response.
public void WriteResponseDocument(XmlDocument document) - Posts the contents of document to the response.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument to the response.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument from the request.

Microsoft.POXUtils.Common

Handles low-level streaming, serialization and deserialization for Client and POXPage.

internal static void WriteStream(Stream inputStream, Stream outputStream, int length) - Copies the contents of inputStream to outputStream.
private static void WriteStream(Stream outputStream, byte[] streamBuffer,int length) - Copies the contents of streamBuffer to outputStream.
internal static MemoryStream ReadStream(Stream inputStream, int length) - Reads the contents of inputStream and returns a new MemoryStream.
internal static MemoryStream SerializeObject<T>(T objectToSerialize, XmlWriterSettings writerSettings) - Serializes objectToSerialize to a MemoryStream using the provided settings.
internal static T DeserializeObject<T>(Stream inputStream, XmlReaderSettings readerSettings) - Deserializes inputStream to an instance of type T using the provided settings.
internal static XmlDocument GetDocumentFromStream(Stream stream, XmlReaderSettings readerSettings) - Loads the contents of stream into an XmlDocument using the provided settings.
internal static MemoryStream GetStreamFromDocument(XmlDocument document, XmlWriterSettings writerSettings) - Writes the contents of document to a stream using the provided settings.

Releases

.1 Alpha - http://www.codeplex.com/POXNET/Release/ProjectReleases.aspx?ReleaseId=2183

UPDATED WIKI: Home

gblock — Wed, 07 Mar 2007 19:24:18 GMT

Microsoft.POXUtils

Microsoft.POXUtils.Client

Provides methods for posting and retreving XML Serializable objects, streams and XML Documents to a POX Service.

public void Post<T>(T objectToPost) - Serializes objectToPost and then posts the stream to a POX service.
public void PostDocument(XmlDocument document) - Posts the contents of an document to a POX service.
public void PostStream(stream documentStream) - Posts a stream to a POX service.
public T GetResponse<T>() - Retrieves the result stream from a POX service an deserializes to an instance of type T.
public XmlDocument GetResponseDocument() - Retrives the result stream from a POX service returns an XmlDocument loaded with that stream.
public MemoryStream GetResponseStream() - Retrieves the result stream from a POX service and loads it into a MemoryStream.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument.

Microsoft.POXUtils.POXPage

Provides an inherited System.Web.UI.Page class that exposes methods for handling a POX web request and response.

public T GetRequest<T>() - Retrieves the request stream and deserializes to an instance of type T.
public T GetRequestDocument() - Retrieves the request stream and returns an XmlDocument loaded with that stream.
public void WriteResponse<T>(T objectToWrite) - Serializes objectToWrite and then posts the stream to the response.
public void WriteResponseDocument(XmlDocument document) - Posts the contents of document to the response.
public XmlWriterSettings WriterSettings - Allows ovewriting the settings for the internal XmlSerializer to use when posting an object or an XmlDocument to the response.
public XmlReaderSettings ReaderSettings - Allows overwriting the settings for the internal XmlSerializer to use when deserializing an object or retrieving an XmlDocument from the request.

Microsoft.POXUtils.Common

Handles low-level streaming, serialization and deserialization for Client and POXPage.

internal static void WriteStream(Stream inputStream, Stream outputStream, int length) - Copies the contents of inputStream to outputStream.
private static void WriteStream(Stream outputStream, byte[] streamBuffer,int length) - Copies the contents of streamBuffer to outputStream.
internal static MemoryStream ReadStream(Stream inputStream, int length) - Reads the contents of inputStream and returns a new MemoryStream.
internal static MemoryStream SerializeObject<T>(T objectToSerialize, XmlWriterSettings writerSettings) - Serializes objectToSerialize to a MemoryStream using the provided settings.
internal static T DeserializeObject<T>(Stream inputStream, XmlReaderSettings readerSettings) - Deserializes inputStream to an instance of type T using the provided settings.
internal static XmlDocument GetDocumentFromStream(Stream stream, XmlReaderSettings readerSettings) - Loads the contents of stream into an XmlDocument using the provided settings.
internal static MemoryStream GetStreamFromDocument(XmlDocument document, XmlWriterSettings writerSettings) - Writes the contents of document to a stream using the provided settings.

UPDATED WIKI: Home

gblock — Wed, 07 Mar 2007 07:07:07 GMT

Project Description
POX.NET is a set of utility classes that assist in creating POX (Plain Old Xml) clients and servers in .NET 2.0. This libary leverages classes within .NET 2.0 and does not require any additional add-ons. With POX.NET you can create a POX client and server with a few lines of code.

Background:

Recently I was working on an internal project that required me to invoke a set of POX (Plain Old XML) services from a windows client application. For those that don’t know what POX is, it’s basically a web page that receives and returns XML content. How does this differ from an ASMX? Web services transfer SOAP messages, while POX services carry any kind of XML you can think of. SOAP uses well defined contracts for passing data back and forth. Also SOAP supports advanced protocols such as WS-*. POX services on the other hand are kind of the outlaws of the services world in that there are very few constraints imposed. That does not mean that constraints cannot be enforced, for example by creating an XSD, but it means that the message format itself is completely open.

Here’s an example of a simple POX request message for illustrative purposes.

<?xml version="1.0" encoding="utf-8" ?>
<order orderNumber="12345" account="acme" accountNo="999" >
<items>
<item productNumber="12345678" qty="5" price="29.99"/>
<item productNumber="87654321" qty="10" price="35.99"/>
</items>
</order>

The response from the POX service might look like this.

<?xml version="1.0" encoding="utf-8" ?>
<orderResponse orderNumber="12345" account="acme" accountNo="999" >
<status>confirmed</status>
<confirmationNo>1000</confirmationNo>
</orderResponse>

In the early days when XML first appeared on the scene, POX services were quite common. Often POX was (and is still used) for doing AJAX style application development. Additionally it is not uncommon for POX style services to be used on the corporate intranet (as in my example). Now for making POX calls Microsoft provides the XMLHTTP object along with the MSXML parser. The XMLHTTP object provides the ability to post an XML string off to a URL and to receive a response either synchronously or asynchronously. As IE supports instantiating COM objects, this makes XMLHTTP the perfect answer for invoking POX from both windows and web clients.

Now flash forward to .NET. So what kind of support do we have natively in .NET for doing POX? It turns out very little. Basically you can do it, but you have to manage the streams and the transport yourself. POX is supported in WCF, but my application was not using .NET 3.0 and I really wanted to find a way to support it in 2.0. Another option was to use XMLHTTP via interop, but that seemed less than optimal.