.NET 接口

本部分描述了 .NET 类接口及其属性和方法。

下表概述了在 IBM.XMS 名称空间中定义的接口。

表 1. .NET 类接口的摘要
接口	描述
IBytesMessage	字节消息是其主体由字节流组成的消息。
IConnection	Connection 对象表示应用程序到消息传递服务器的活动连接。
IConnectionFactory	应用程序使用连接工厂来创建连接。
IConnectionMetaData	ConnectionMetaData 对象提供有关连接的信息。
IDestination	目标是应用程序发送消息的位置和/或应用程序从中接收消息的源。
ExceptionListener	应用程序使用异常侦听器来获得连接问题的异步通知。
IllegalStateException	如果应用程序在不正确或不适当的时间调用方法，或者如果 XMS 未处于所请求操作的适当状态，那么 XMS 将抛出此异常。
InitialContext	应用程序使用 InitialContext 对象，通过从受管对象存储库中检索的对象定义来创建对象。
InvalidClientIDException	如果应用程序尝试为连接设置客户机标识，但该客户机标识无效或已在使用中，那么 XMS 将抛出此异常。
InvalidDestinationException	如果应用程序指定的目标无效，那么 XMS 将抛出此异常。
InvalidSelectorException	如果应用程序提供了语法无效的消息选择器表达式，那么 XMS 将抛出此异常。
IMapMessage	映射消息是消息主体由一组名称/值对组成的消息，其中每个值都有关联的数据类型。
IMessage	Message 对象表示应用程序发送或接收的消息。 IMessage 是诸如 IMapMessage 等消息类的超类。
IMessageConsumer	应用程序使用消息使用者接收向目标发送的消息。
MessageEOFException	如果 XMS 在应用程序读取字节消息的主体时迂到字节消息流的结尾，那么 XMS 将抛出此异常。
MessageFormatException	如果 XMS 迂到格式无效的消息，那么 XMS 将抛出此异常。
IMessageListener（委托）	应用程序使用消息侦听器以异步方式接收消息。
MessageNotReadableException	如果应用程序尝试读取仅写入的消息体，那么 XMS 将抛出此异常。
MessageNotWritableException	如果应用程序尝试写入只读消息的主体，那么 XMS 将抛出此异常。
IMessageProducer	应用程序使用消息生产者向目标发送消息。
IObjectMessage	对象消息是其主体包含序列化 Java 或 .NET 对象的消息。
IPropertyContext	IPropertyContext 是包含用于获取和设置属性的方法的抽象超类。其他类将继承这些方法。
IQueueBrowser	应用程序使用队列浏览器来浏览队列中的消息，而不将其除去。
Requestor	应用程序可以使用请求程序来发送请求消息，然后等待接收应答。
ResourceAllocationException	如果 XMS 无法分配方法所需的资源，那么 XMS 将抛出此异常。
SecurityException	如果为认证应用程序而提供的用户标识和密码被拒绝，那么 XMS 将抛出此异常。如果权限检查失败并阻止方法完成，那么 XMS 也会抛出此异常。
ISession	会话是用于发送和接收消息的单线程上下文。
IStreamMessage	流消息是消息主体由一连串值组成的消息，其中每个值都有关联的数据类型。
ITextMessage	文本消息是消息主体由字符串组成的消息。
TransactionInProgressException	XMS 在应用程序请求由于事务正在进行而无效的操作时抛出此异常。
TransactionRolledBackException	如果应用程序调用 Session.commit() 以落实当前事务，但该事务随后回滚，那么 XMS 将抛出此异常。
XMSC	对于 .NET， XMS 属性名称和值在此类中定义为公共常量。有关更多详细信息，请参阅 XMS 对象的属性。
XMSException	如果 XMS 在处理对 .NET 方法的调用时检测到错误，那么 XMS 会抛出异常。异常是用于封装错误相关信息的对象。存在不同类型的 XMS 异常，而 XMSException 对象只是一种类型的异常。但是， XMSException 类是其他 XMS 异常类的超类。 XMS 在其他类型的异常都不适用的情况下抛出 XMSException 对象。
XMSFactoryFactory	如果应用程序没有使用受管对象，请使用此类来创建连接工厂、队列和主题。

每个方法的定义都列出了 XMS 在处理对该方法的调用时检测到错误时可能返回的异常代码。每个异常代码都由其命名常量表示，而命名常量都有各自对应的异常。