SMTP WSDL Extensibility Elements

The SMTP WSDL extensibility elements allow the user to "configure" 2 sets of information for use in the SMTP Binding Component: SMTP connectivity information and binding information to convert WSDL messages to and from SMTP messages.

This page describes the elements for each of these 2 groups.

---

SMTP Connectivity

The SMTP address extensibily element allows the user to specify the endpoint for mail message.

SMTP address element attributes:

Attribute Name	Description	Mandatory	Example
location	A URL which specifies the location of the receiver. The URL follows the standard "mailto" URL Scheme from RFC 2368	Yes	mailto:someuser@somedomain.com
smtpserver	The SMTP server used by the client interactions. When the server is implementing this WSDL, this attribute is ignored	No	mail.google.com

The following is a sample usage of the SMTP address extensiblity element defined for a service port,

<port binding="y:binding" name="smtpEndpoint">
   <smtp:address location="mailto:someuser@somedomain.com" smtpserver="mail.google.com"/>
</port>

Notes on location: The URL scheme must conform to RFC 2368.

---

SMTP Binding

The SMTP extensibility elements for binding abstract WSDL messages to SMTP messages fall into several sections. Each section signifies how the binding should occur. At the binding level, the configuration applies to the entire port type. At the operation level, the configuration applies only to the operation. At the message level, the configuration applies to that particular message, whether it's input or output.

The SMTP binding Element

The purpose of the SMTP binding element is to signify that the binding is bound to the SMTP protocol format.

SMTP binding element attributes:

Attribute Name	Description	Mandatory	Example

SMTP binding sub-elements:

Element Name	Description	Mandatory	Example
proxy	Represents a proxy to route SMTP messages through	No	*See smtp:proxy section*

The smtp:binding element MUST be present when using the SMTP binding.

<definitions .... >
    <binding .... >
        <smtp:binding />
    </binding>
</definitions>

The SMTP proxy Element

The SMTP proxy element is a sub-element of the SMTP binding Element. This element is currently unsupported, but is included here for future features.

SMTP proxy element attributes:

Attribute Name	Description	Mandatory	Example
host	The host for sending SMTP messages	Yes	proxyhost.com
port	The port used for sending SMTP messages. This must be an integer corresponding to a semantically correct port number	No	25
userName	The user name for sending SMTP messages	No	user
password	The password for sending SMTP messages	No	password

The smtp:proxy element is optional when using the smtp:binding element.

<definitions .... >
    <binding .... >
        <smtp:binding>
            <smtp:proxy host="proxyhost.com" port="25" userName="user" password="password">*
        </smtp:binding>
    </binding>
</definitions>

The SMTP operation Element

The purpose of the SMTP operation element is to provide binding information from the abstract operation to the concrete smtp operation.

SMTP operation element attributes:

Attribute Name	Description	Mandatory	Example

<definitions .... >
    <binding .... >
        <operation .... >
           <smtp:operation />
        </operation>
    </binding>
</definitions>

The SMTP input Element

The smtp:input element specifies how the message parts appear inside a SMTP message.

SMTP input element attributes:

Attribute Name	Description	Mandatory	Example
message	Refers to the message part containing the SMTP message to be sent.	No	part1
from	Refers to the message part containing the sender of the SMTP message. This is generally an email address	No	part1
subject	Refers to the message part containing the subject of the SMTP message.	No	part1
charset	Refers to the message part containing the character set of the SMTP message.	No	utf-8

SMTP input sub-elements:

Element Name	Description	Mandatory	Example
attachment	Represents an attachment to a SMTP message	No	*See smtp:attachment section*

<definitions .... >
    <binding .... >
        <operation .... >
           <input>
               <smtp:input message="nmtokens"? subject="nmtokens"? from="nmtokens"?
                           charset="string"? />
           </input>
        </operation>
    </binding>
</definitions>

Notes on message, from, and subject: These elements MUST refer to part names from the input message.

The SMTP attachment Element

The attachment element is a sub-element of the smtp:input element. This element is currently unsupported but is included for future feature enhancements.

SMTP attachment element attributes:

Attribute Name	Description	Mandatory	Example
contentType	Refers to the message part containing the content type of the attachment	Yes	part1
name	Indicates how message parts will be encoded in the SMTP fault	Yes	part1
content	Indicates a particular encoding style to use	Yes	part1

<definitions .... >
    <binding .... >
        <operation .... >
           <input>
               <smtp:input message="nmtokens"? subject="nmtokens"? from="nmtokens"?
                           charset="string"?>
                   <smtp:attachment contentType="nmtokens" name="nmtokens" content="nmtokens"/>
               </smtp:input>
           </input>
        </operation>
    </binding>
</definitions>

Notes on contentType, name, and nmtokens: These elements MUST refer to part names from the input message.

This page (revision-2) was last changed on 07-Dec-06 06:04 AM, -0800 by 192.18.17.3.
This page was created on 09-Nov-06 15:01 PM, -0800 by BCWiki.

More info...