SOAP入门教程：创建与发送简单消息

"SOAP入门教程，由汤国华编著，涵盖了创建和发送简单消息、添加消息内容到头部和主体、使用SAAJ或DOM API操作消息内容、添加附件以及处理SOAP错误等内容，旨在帮助初学者理解并掌握SOAP通信基础。" 在本文档中，作者详细介绍了SOAP（Simple Object Access Protocol）的基础知识，这是一个用于交换结构化和类型化的信息的协议，常用于Web服务。以下是关键知识点的详细说明： 1. 创建和发送简单消息 - 创建消息：使用SAAJ（SOAP with Attachments API for Java）提供的MessageFactory类的实例来创建SOAPMessage对象。 ```java MessageFactory factory = MessageFactory.newInstance(); SOAPMessage message = factory.createMessage(); ``` 2. 消息的组成部分 - SOAP消息通常包含消息头（Header）和消息体（Body）两部分，其中消息体是实际数据的载体。 3. 访问消息元素 - 可以通过SOAPMessage对象的getHeader()和getBody()方法访问消息头和消息体。 - 对消息结构进行遍历，可以使用DOM（Document Object Model）API解析和操作XML结构。 4. 添加内容到消息体 - 使用SOAPBody对象的addBodyElement()方法添加新的SOAP元素。 5. 获取SOAP连接对象 - 创建SOAPConnection对象以发送SOAP请求，通过MailSession或HTTPTransport实现。 6. 发送消息 - 调用SOAPConnection的call()方法，传入SOAPMessage对象和目标地址来发送消息。 7. 获取消息内容 - 使用SOAPMessage的getContent()方法获取整个消息内容，或者使用SOAPBody的getChildElements()获取具体元素。 8. 添加内容到头部 - 头部通常用于传递元信息，如认证、路由等，可以使用SOAPHeader对象的addHeaderElement()方法添加新元素。 9. 添加内容到SOAPPart对象 - SOAPPart对象代表整个SOAP消息，可以将XML文档添加到其中作为消息内容。 10. 将文档添加到SOAPBody - 通过SOAPBody的addDocument()方法将一个XML Document对象添加到SOAPBody。 11. 使用SAAJ或DOM API操作消息内容 - SAAJ提供对SOAP消息的直接操作，如添加、删除和修改元素。 - DOM API则用于更底层的XML结构操作，可以自由地构建和解析XML树。 12. 添加附件 - 创建AttachmentPart对象，设置其内容，然后添加到SOAPMessage的Attachments集合中。 - 通过AttachmentPart对象访问和操作附件。 13. 添加属性 - SOAP头元素可以有属性，例如Actor、Role、MustUnderstand和Relay。 - 这些属性控制消息的处理方式，如指定接收者、标记必须理解的头元素等。 14. 使用SOAPFaults - SOAPFault用于表示通信过程中的错误，它包含在SOAPBody中，提供了详细的错误信息。 本教程详细介绍了SOAP通信的基本流程和关键操作，适合初学者学习和实践，为理解和开发基于SOAP的Web服务打下基础。通过这些步骤，读者能够创建、发送并处理SOAP消息，理解如何在SOAP消息中添加和操作内容，以及处理可能出现的错误情况。