Open your thoughts » XML

定制 xmlbeans 所生成的 package

javafuns — Sun, 15 Aug 2010 09:29:14 +0000

xmlbeans 也是 XML binding 工具之一，不了解的同学可以去了解一下，是这方面比较流行的框架之一。本篇不会长篇累牍的去介绍如何使用，相信在这方面，官方文档已足够。

我们知道，xmlbeans 提供了命令行工具，同时也有 ant task，支持把 xsd 生成 Java class 这一功能。xmlbeans 所生成的这些 classes 的 package 其实是有一定规律的。默认情况下，package 是根据 namespace 和元素类型而定。在某些情况下，特别是这个 xsd 并不是我们所能控制的情形下，我们需要生成不同于 namespace 的 package，这时就需要我们做出一些特殊处理。

命令行：scomp -d ..\classes -src ..\src -javasource 1.5 EasyPO.xsd po.xsdconfig

ant task：

注意，在 ant task 下，只需要把 po.xsdconfig 放在与 EasyPO.xsd 同一目录即可。

2009/03/01 -- Java 程序中如何对 XML 文档进行验证？
2009/07/23 -- XML 中的 schemaLocation 属性究竟是什么意思？
2009/07/07 -- Which style of WSDL should I use? (reship)
2009/05/15 -- HIBERNATE－为DB2指定默认schema
2009/03/02 -- 关于 XML standalone 的解释

A brief introduction of what is RDF

javafuns — Wed, 04 Aug 2010 06:25:22 +0000

The Resource Description Framework (RDF) is a language for representing information about resources in the World Wide Web. It provides a graph structure for making statements about things. RDF is designed to be read and understood by computers. It is not designed to be displayed to people. RDF is the W3C standard for encoding knowledge. It is a specification that fills a particular niche for decentralized, distributed knowledge and provides a framework to enable computer applications to handle data.

RDF was originally created in 1999 as a standard on top of XML for encoding metadata, e.g. data about data. It is a foundation for processing metadata.

RDF specifies the data model and syntax for sharing knowledge about concepts on the Web. It does not specify how concepts may relate to one another.

RDF has a simple data model, based on triples:

subject predicate object

It is a graph-based formalism for representing metadata, where the subject and the object are things (entities), and the predicate denotes the relationship between them. Each triple represents a fact. The figure below shows Peter to be the subject of the triple, Sofia to be the object, and lives into be the predicate describing the relationship between Peter, the subject, and Sofia, the object of the triple.

RDF triple

The subject and object are nodes and the predicate (e.g. the property) – an arc. Properties are represented as a directed arc, so they are only valid from subject to object.

RDF statements form a graph by being able to share subjects and objects. Also, the subject of one statement can be the object of another and vice versa. For instance, the figure below shows Sofia to be the object of the triple Peter lives in Sofia and the subject of the triple Sofia located in Bulgaria, and Peter to be the subject of both triples: Peter lives in Sofia and Peter has website www.peter.com.

RDF Graph

Each subject, predicate and object can have a name, a URI. In the RDF model, these values are called RDF resources. So, an RDF triple really looks like this:

Subject	Predicate	Object
`http://www.anon.com/foaf#Peter`	http://www.location.org/rdf#lives_in	`http://www.dbpedia.org/resource/Sofia`

Each resource is uniquely identified on the Web.

RDF graphs can be represented in XML. This is the RDF/XML syntax. XML encoding allows the graphs to be exchanged on the web. The example below shows the representation of the triple Peter lives in Sofia in RDF/XML.

xmlns:ex="http://www.location.org/"

RDF provides a model for making logical statements which could be used for inference tasks. It is aligned to the Web architecture and is simple enough for uptake and usage. However, it does not specify how concepts may relate to one another.

RDF is part of the W3C‘s Semantic Web Activity. It is a W3C Recommendation.

The Resource Description Framework Schema (RDFS) is an extension of RDF. It allows to define simple ontologies – models about concepts and their properties. They can be used to conclude new knowledge.

The Web Ontology Language (OWL) extends RDFS. It makes richer models of knowledge about things possible, but at the cost of those models being more complex for a computer to process.

Original Location: http://ontotext.com/factforge/rdf.html

2010/08/15 -- 定制 xmlbeans 所生成的 package
2010/06/09 -- RDF 中的术语
2009/10/21 -- Tutorial of SOAP with Attachments API for Java
2009/07/23 -- XML 中的 schemaLocation 属性究竟是什么意思？
2009/07/19 -- SMTP Transport Binding for SOAP

Tutorial of SOAP with Attachments API for Java

javafuns — Wed, 21 Oct 2009 07:42:01 +0000

随着web 服务、SOA 概念的兴起，和诸多 SOA 应用的实践，Java 阵营也审时度势，趁势推出相应的 API 以应对这一变化。SOAP 是 Java web 服务栈中很基础的一项技术，web 服务间以 SOAP 消息来互相通信。
SOAP with Attachments API for Java(简称 SAAJ) 就是 Java 阵营为访问 web 服务所提供的基础设施，它简化了对 SOAP 的处理。
SAAJ 包含 2 部分 APIs，其一用于创建消息，添加消息内容，其二则用于建立连接，发送 SOAP 消息。

一. 创建 SOAP 消息

SOAP 消息的 XML 文档结构在前一篇文章中已有图示。其中，SAAJ APIs 中的 SOAPMessage 类表示一个 SOAP 消息，SOAPPart 类表示 SOAP part，SOAPEnvelope 接口表示 SOAP envelope，等等。很多 SAAJ APIs 的接口都继承了 DOM 接口。
当创建一个 SOAPMessage 时，该 SOAPMessage 会自动创建并包含 SOAP 消息所必须的部分：一个新的 SOAPMessage 对象会包含一个 SOAPPart 对象，这个 SOAPPart 则包含有一个 SOAPEnvelope 对象，该 SOAPEnvelope 对象会包含一个空的SOAPHeader 对象，紧接着是一个空的 SOAPBody 对象。SOAPHeader 在 SOAP 消息中是可选的，这里之所以自动创建它，是因为我们在 SOAP 消息中经常会使用到它。

MessageFactory factory = MessageFactory.newInstance();
SOAPMessage message = factory.createMessage();

默认是创建 SOAP 1.1 的消息，如果想要创建 SOAP 1.2 消息，那么代码如下：

MessageFactory factory = MessageFactory.newInstance(SOAPConstants.SOAP_1_2_PROTOCOL);

如果既想创建 SOAP 1.1 消息，又想创建 SOAP 1.2 消息，那么代码如下：

MessageFactory factory = MessageFactory.newInstance(SOAPConstants.DYNAMIC_SOAP_PROTOCOL
);

接着，向消息中添加内容。

首先取得 SOAPMessage 中的 SOAPPart 对象：

SOAPPart soapPart = message.getSOAPPart();

然后，我们从 SOAPPart 中取出 SOAPEnvelope 对象：

SOAPEnvelope envelope = soapPart.getEnvelope();

有了 SOAPEnvelope 对象，就可以得到它的 SOAPHeader 和 SOAPBody 了。

SOAPHeader header = envelope.getHeader();
SOAPBody body = envelope.getBody();

不过，你可能觉得做了这么多的工作才取得 SOAPHeader 和 SOAPBody 是不是太麻烦了？ SAAJ APIs 提供了便捷通道，直接通过 SOAPMessage 就可以获得 SOAPHeader 和 SOAPBody 对象：

SOAPHeader header = message.getSOAPHeader();
SOAPBody body = message.getSOAPBody();

由于 SOAPHeader 是可选的，如果你不需要它，便可以去掉它，可以使用 DOM 接口的方法来删除：

header.detachNode();

下面向 SOAPBody 对象中添加内容：

SOAPBody body = message.getSOAPBody();
QName bodyName = new QName("http://wombat.ztrade.com", "GetLastTradePrice", "m");
SOAPBodyElement bodyElement = body.addBodyElement(bodyName);
QName name = new QName("symbol");
SOAPElement symbol = bodyElement.addChildElement(name);
symbol.addTextNode("SUNW");

这时的 SOAPBody 内容如下所示：
SUNW

如果你有一个以文件形式存在的 SOAP 消息，那么如下方式会使用创建一个 SOAPMessage 更便捷：

DocumentBuilderFactory dbFactory = DocumentBuilderFactory.newInstance();
dbFactory.setNamespaceAware(true);
DocumentBuilder builder = dbFactory.newDocumentBuilder();
Document document = builder.parse("file:///music/order/soap.xml");
DOMSource domSource = new DOMSource(document);

SOAPPart soapPart = message.getSOAPPart();
soapPart.setContent(domSource);

当然，如果已有一个 DOM document，想将它通过 SOAP 发送出去，SAAJ APIs 也提供了便捷方式：

SOAPBody body = message.getSOAPBody();
SOAPBodyElement docElement = body.addDocument(document);

一个 SOAPMessage 可以包含一个或多个 attachment part，在 SAAJ APIs 中，使用 AttachmentPart 类表示 attachment part。由于 AttachmentPart 在 SOAPMessage 中是可选的，因此必须自己亲自动手去创建和添加它。如果一个 SOAPMessage 对象有一个或多个 attachments, 则每个 AttachmentPart 对象必须有一个 MIME header 用于指示它所包含的数据的类型。

二. 创建连接并发送 SOAP 消息

当消息已经创建好后，可以使用各种机制发送(例如JMS 或 JAXM)。在 SAAJ APIs 中，也提供了简单的发送机制。它使用 SOAPConnection 代表连接，SOAPConnection 对象是一中 point-to-point 连接，意味着它是直接从发送方到目标。
首先创建连接 SOAPConnection 对象：

SOAPConnectionFactory soapConnectionFactory = SOAPConnectionFactory.newInstance();
SOAPConnection connection = soapConnectionFactory.createConnection();

发送消息：

java.net.URL endpoint = new URL("http://wombat.ztrade.com/quotes");
SOAPMessage response = connection.call(message, endpoint);

一个连接使用了相当多的资源，所以使用结束后应尽早关闭：

connection.close();

处理响应内容：

SOAPBody soapBody = response.getSOAPBody();
java.util.Iterator iterator = soapBody.getChildElements(bodyName);
SOAPBodyElement bodyElement = (SOAPBodyElement)iterator.next();
String lastPrice = bodyElement.getValue();
System.out.print("The last price for SUNW is ");
System.out.println(lastPrice);

三. 带附件的 SOAP 消息

SAAJ APIs 中有 3 种方式创建附件。
第一种：创建一个没有内容的附件

AttachmentPart attachment = message.createAttachmentPart();
String stringContent = "Update address for Sunny Skies " + "Inc., to 10 Upbeat Street, Pleasant Grove, CA 95439";
attachment.setContent(stringContent, "text/plain");
attachment.setContentId("update_address");
message.addAttachmentPart(attachment);

setContent 方法的第一个参数 Object 是附件内容，第二个参数 String 则是 MIME 内容类型。MIME 内容类型会写入到 AttachmentPart 的 Header，且这个 MIME content type 是唯一强制要有的。SAAJ 提供了 Content-Type, Content-Id, and Content-Location headers 的 getter 和 setter 方法。

另外 2 个 SOAPMessage.createAttachment 方法会创建带内容的附件。其中一个方法，其参数类似于 AttachmentPart.setContent，它的 Object 可以是一个 String, 一个 stream, 一个 javax.xml.transform.Source object, 或者一个 javax.activation.DataHandler object。
另外一个方法则需要参数 DataHandler object，来自于 JavaBeans Activation Framework (JAF) APIs. 使用一个 DataHandler object 是相当直观的。首先，为想要添加到附件中的文件创建一个 java.net.URL object。然后创建一个 DataHandler object：

URL url = new URL("http://greatproducts.com/gizmos/img.jpg");
DataHandler dataHandler = new DataHandler(url);
AttachmentPart attachment = message.createAttachmentPart(dataHandler);
attachment.setContentId("attached_image");
message.addAttachmentPart(attachment);

这里之所以没有设置 MIME content type header，是因为 DataHandler 会含有这方面的信息。

访问附件内容：

java.util.Iterator iterator = message.getAttachments();
while (iterator.hasNext()) {
AttachmentPart attachment = (AttachmentPart)iterator.next();
String id = attachment.getContentId();
String type = attachment.getContentType();
System.out.print("Attachment " + id + " has content type " + type);
if (type.equals("text/plain")) {
Object content = attachment.getContent();
System.out.println("Attachment contains:\n" + content);
}
}

四. 创建 SOAPFault
for SOAP 1.1

SOAPBody body = message.getSOAPBody();
SOAPFault fault = body.addFault();
QName faultName =
new QName(SOAPConstants.URI_NS_SOAP_ENVELOPE, "Server");
fault.setFaultCode(faultName);
fault.setFaultActor("http://gizmos.com/orders");
fault.setFaultString("Server not responding");

还可以向 SOAPFault 对象添加详细信息：

Detail detail = fault.addDetail();
QName entryName = new QName("http://gizmos.com/orders/", "order", "PO");
DetailEntry entry = detail.addDetailEntry(entryName);
entry.addTextNode("Quantity element does not have a value");
QName entryName2 = new QName("http://gizmos.com/orders/", "order", "PO");
DetailEntry entry2 = detail.addDetailEntry(entryName2);
entry2.addTextNode("Incomplete address: no zip code");

注意：一个 SOAPFault 对象只能有一个 Detail 对象。

获取 SOAPFault 信息：

SOAPBody body = newMessage.getSOAPBody();
if ( body.hasFault() ) {
SOAPFault newFault = body.getFault();
QName code = newFault.getFaultCodeAsQName();
String string = newFault.getFaultString();
String actor = newFault.getFaultActor();
System.out.println("SOAP fault contains: ");
System.out.println(" Fault code = " + code.toString());
System.out.println(" Local name = " + code.getLocalPart());
System.out.println(" Namespace prefix = " + code.getPrefix() + ", bound to " + code.getNamespaceURI());
System.out.println(" Fault string = " + string);
if ( actor != null ) {
System.out.println(" Fault actor = " + actor);
}

访问详细信息：

Detail newDetail = newFault.getDetail();
if (newDetail != null) {
Iterator entries = newDetail.getDetailEntries();
while ( entries.hasNext() ) {
DetailEntry newEntry = (DetailEntry)entries.next();
String value = newEntry.getValue();
System.out.println(" Detail entry = " + value);
}
}

五. 参考资料

The Java™ Web Services Tutorial (For Java Web Services Developer’s Pack, v2.0)

2009/07/19 -- SMTP Transport Binding for SOAP
2009/07/07 -- Which style of WSDL should I use? (reship)
2009/10/15 -- Structures of SOAP with Attachments
2008/07/29 -- What’s New in WSDL 2.0
2008/07/19 -- UDDI 规范 v3.0.2 – UDDI Programmers APIs 之 Custody and Ownership Transfer API Set

XML 中的 schemaLocation 属性究竟是什么意思？

javafuns — Thu, 23 Jul 2009 05:43:34 +0000

在 XML 实例文档中有时会发现有 schemaLocation 属性。很多人对此非常疑惑，搞不清这个属性究竟是什么意思，究竟该如何使用。

schemaLocation 属性用来引用(schema)模式文档，解析器可以在需要的情况下使用这个文档对 XML 实例文档进行校验。它的值(URI)是成对出现的，第一个值表示命名空间，第二个值则表示描述该命名空间的模式文档的具体位置，两个值之间以空格分隔。当然，在必要情况下，可以为 schemaLocation 属性指派多个这样的值对。

如果为没有目标命名空间的模式文档指定位置，需用 noNamespaceSchemaLocation 属性.

2010/08/15 -- 定制 xmlbeans 所生成的 package
2009/07/07 -- Which style of WSDL should I use? (reship)
2009/03/01 -- Java 程序中如何对 XML 文档进行验证？
2008/07/29 -- What’s New in WSDL 2.0
2010/08/04 -- A brief introduction of what is RDF

SMTP Transport Binding for SOAP

javafuns — Sun, 19 Jul 2009 15:37:40 +0000

SOAP 除了可以 bind 到 HTTP 上外, 也可以 bind 到 SMTP 上. 其实个人感觉, SOAP bind 到 SMTP 上的场景很少会使用到, 通常限于 one-way operation (比如通知等不需要响应). 如果需要实现 request/response, 那么是需要多做一些工作的(下文会有叙述).

soap:binding element 的 transport 属性需指定一个 http://xxx(例如:http://schemas.xmlsoap.org/soap/smtp) URL 来表明所要 binding 的 protocol. 似乎这个 URL 是任意形式, 只要能让调用方知道要使用什么协议即可. 在 soap:address 要给定 mailto:xxxx@xxx.xxx 这样形式的 URI.

注意: 在 soap:address element 中, 可能会有一些扩展元素, 例如smtp server, smtp username, smtp password, etc.

在需要 request / response 语义情况下, 需使用标准的 Message-Id 和 In-Reply-To SMTP header 来实现这一目标. 请求包含一个 Message-Id header, 相应的响应则在 In-Reply-To header 中使用请求的 Message-Id header 值, 同时也创建一个新的 Message-Id header. 这样, 在请求与响应之间便建立了关联.

请求:

To: 
 From: 
 Reply-To: 
 Date: Tue, 15 Nov 2001 23:27:00 -0700
 Message-Id: <1F75D4D515C3EC3F34FEAB51237675B5@client.com>
 MIME-Version: 1.0
 Content-Type: text/xml; charset=utf-8
 Content-Transfer-Encoding: QUOTED-PRINTABLE

 
 
 
 
 get your SOAP over SMTP here !

响应:

To: 
 From: 
 Date: Tue, 13 Nov 2001 23:27:00 -0700
 In-Reply-To: <1F75D4D515C3EC3F34FEAB51237675B5@client.com>
 Message-Id: 
 MIME-Version: 1.0
 Content-Type: TEXT/XML; charset=utf-8
 Content-Transfer-Encoding: QUOTED-PRINTABLE

 
 
 
 
 get your SOAP over SMTP here !

Resources:

2009/07/07 -- Which style of WSDL should I use? (reship)
2008/07/19 -- UDDI 规范 v3.0.2 – UDDI Programmers APIs 之 Custody and Ownership Transfer API Set
2008/07/15 -- UDDI 规范 v3.0.2 – UDDI Programmers APIs 之 Value Set API Set
2008/07/13 -- UDDI 规范 v3.0.2 – UDDI Programmers APIs 之 Security Policy API Set
2008/07/07 -- UDDI 规范 v3.0.2 – UDDI Programmers APIs 之 Publication API Set(3)

Which style of WSDL should I use? (reship)

javafuns — Tue, 07 Jul 2009 08:40:25 +0000

Russell Butek (butek@us.ibm.com), SOA and Web services consultant, IBM

Date: 24 May 2005 (Published 31 Oct 2003)
Level: Advanced

Summary: A Web Services Description Language (WSDL) binding style can be RPC or document. The use can be encoded or literal. How do you determine which combination of style and use to use? The author describes the WSDL and SOAP messages for each combination to help you decide.

Introduction

A WSDL document describes a Web service. A WSDL binding describes how the service is bound to a messaging protocol, particularly the SOAP messaging protocol. A WSDL SOAP binding can be either a Remote Procedure Call (RPC) style binding or a document style binding. A SOAP binding can also have an encoded use or a literal use. This gives you four style/use models:

RPC/encoded
RPC/literal
Document/encoded
Document/literal

Add to this collection a pattern which is commonly called the document/literal wrapped pattern and you have five binding styles to choose from when creating a WSDL file. Which one should you choose?

Before I go any further, let me clear up some confusion that many of us have stumbled over. The terminology here is very unfortunate: RPC versus document. These terms imply that the RPC style should be used for RPC programming models and that the document style should be used for document or messaging programming models. That is not the case at all. The style has nothing to do with a programming model. It merely dictates how to translate a WSDL binding to a SOAP message. Nothing more. You can use either style with any programming model.

Likewise, the terms encoded and literal are only meaningful for the WSDL-to-SOAP mapping, though, at least here, the traditional meanings of the words make a bit more sense.

For this discussion, let’s start with the Java method in Listing 1 and apply the JAX-RPC Java-to-WSDL rules to it (see Resources for the JAX-RPC 1.1 specification).

Listing 1. Java method

public void myMethod(int x, float y);

RPC/encoded

Take the method in Listing 1 and run it through your favorite Java-to-WSDL tool, specifying that you want it to generate RPC/encoded WSDL. You should end up with something like the WSDL snippet in Listing 2.
Listing 2. RPC/encoded WSDL for myMethod

Now invoke this method with “5″ as the value for parameter x and “5.0″ for parameter y. That sends a SOAP message which looks something like Listing 3.
Listing 3. RPC/encoded SOAP message for myMethod

A note about prefixes and namespaces

For the most part, for brevity, I ignore namespaces and prefixes in the listings in this article. I do use a few prefixes that you can assume are defined with the following namespaces:

xmlns:xsd=”http://www.w3.org/2001/XMLSchema”
xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”
xmlns:soap=”http://schemas.xmlsoap.org/soap/envelope/”

For a discussion about namespaces and the WSDL-to-SOAP mapping, see paper “Handle namespaces in SOAP messages you create by hand” (see Resources).

There are a number of things to notice about the WSDL and SOAP message for this RPC/encoded example:

Strengths

The WSDL is about as straightforward as it’s possible for WSDL to be.
The operation name appears in the message, so the receiver has an easy time dispatching this message to the implementation of the operation.

Weaknesses

The type encoding info (such as xsi:type="xsd:int") is usually just overhead which degrades throughput performance.
You cannot easily validate this message since only the 5 and 5.0 lines contain things defined in a schema; the rest of the soap:body contents comes from WSDL definitions.
Although it is legal WSDL, RPC/encoded is not WS-I compliant.

Is there a way to keep the strengths and remove the weaknesses? Possibly. Let’s look at the RPC/literal style.

2009/07/19 -- SMTP Transport Binding for SOAP
2008/07/29 -- What’s New in WSDL 2.0
2008/07/19 -- UDDI 规范 v3.0.2 – UDDI Programmers APIs 之 Custody and Ownership Transfer API Set
2008/07/15 -- UDDI 规范 v3.0.2 – UDDI Programmers APIs 之 Value Set API Set
2008/07/13 -- UDDI 规范 v3.0.2 – UDDI Programmers APIs 之 Security Policy API Set

关于 XML standalone 的解释

javafuns — Mon, 02 Mar 2009 13:09:35 +0000

XML standalone 定义了外部定义的 DTD 文件的存在性. standalone element 有效值是 yes 和 no. 如下是一个例子:
.........
值 no 表示这个 XML 文档不是独立的而是依赖于外部所定义的一个 DTD. 值 yes 表示这个 XML 文档是自包含的(self-contained).

2010/08/15 -- 定制 xmlbeans 所生成的 package
2009/03/01 -- Java 程序中如何对 XML 文档进行验证？
2010/08/04 -- A brief introduction of what is RDF
2010/07/16 -- wait and notifyAll in Java multi-threading
2010/07/13 -- 关于 java.util.concurrent 您不知道的 5 件事(转载)

Java 程序中如何对 XML 文档进行验证？

javafuns — Sun, 01 Mar 2009 13:39:41 +0000

Table Of Content

Introduction

Validation when parsing

Validation against preparsed schema

Validate a DOMSource or SAXSource against preparsed schema

Introduction

XML 作为一种数据存储和描述语言，这些年得到了广泛运用，尤其以web服务为代表。XML之所以广受欢迎，原因之一是它具有丰富的数据描述手段，你甚至可以对要存储的数据做出各种限制: 字符串长度，数字大小，等等。

最早的XML使用DTD(Document Type Definition)进行定义，后来人们又发明了XML Schema。XML Schema本质上也是一种XML，这相比DTD大大减少了学习曲线，而且XML Schema提供了更丰富的校验机制。

参看《XML Schema 与 XML DTD 的技术比较与分析》，有更详细的比较。

Validation when parsing

XML 的解析API 即 JAXP (Java API for XML Processing) 提供有两种方式：SAX(Simple API for XML) 和 DOM。SAX 基于事件方式，边解析边处理，适用于大文件；DOM 则将整个XML文件全部读入，以Tree形式存在于内存中，可以对这个Tree进行增删改等操作。

配置 DocumentBuilderFactory 或 SAXParserFactory

以下语句(以DOM方式为例，SAX同理)使得解析时对XML文档进行校验且命名空间敏感。

DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance()
factory.setNamespaceAware(true);
factory.setValidating(true);
try {
factory.setAttribute("http://java.sun.com/xml/jaxp/properties/schemaLanguage", "http://www.w3.org/2001/XMLSchema");
}
catch (IllegalArgumentException x) {
// Happens if the parser does not support JAXP 1.2
// TODO: code here
}

为XML指定XML Schema

有两种方式：

1). 在XML文档中指定

当有多个XML Schema时：

...

2). 在Java程序中指定

...
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance()
...
factory.setAttribute("http://java.sun.com/xml/jaxp/properties/schemaSource", new File("YourSchemaDefinition.xsd"));

当有多个XML Schema时：

static final String employeeSchema = "employeeDatabase.xsd";
static final String taxSchema = "w2TaxForm.xsd";
static final String hiringSchema = "hiringForm.xsd";

static final String[] schemas = {employeeSchema, taxSchema, hiringSchema};

static final String JAXP_SCHEMA_SOURCE = "http://java.sun.com/xml/jaxp/properties/schemaSource";

...
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance()
...
factory.setAttribute(JAXP_SCHEMA_SOURCE, schemas);

除了File及String Array参数以外，factory.setAttribute()方法的参数还可以是：

一个指向 schema 的 URI 字符串

一个带有 schema 内容的 InputStream

一个 SAX InputSource

一个 File

一个 Object 数组, 它们可以是这里所定义的任何类型(指前几个).

Validation against preparsed schema

javax.xml.validation 包提供了对解析 schema 并根据已解析 schema 验证 XML 文档实例的支持. 可以根据一个已解析的 schema 对一个 DOMSource 或者 SAXSource 进行校验. 必要时, 已经解析的 schema 可以缓存起来以实现优化.

//parse an XML in non-validating mode and create a DOMSource
DocumentBuilderFactory dbfactory = DocumentBuilderFactory.newInstance();
dbfactory.setNamespaceAware(true);
dbfactory.setXIncludeAware(true);

DocumentBuilder parser = dbfactory.newDocumentBuilder();
Document doc = parser.parse(new File("data.xml"));

DOMSource xmlsource = new DOMSource(doc);

//create a SchemaFactory for loading W3C XML Schemas
SchemaFactory wxsfactory = SchemaFactory.newInstance(XMLConstants.W3C_XML_SCHEMA_NS_URI);

//set the errorhandler for handling errors in schema itself
wxsfactory.setErrorHandler(schemaErrorHandler);

//load a W3C XML Schema
Schema schema = wxsfactory.newSchema(new File("myschema.xsd"));

// create a validator from the loaded schema
Validator validator = schema.newValidator();

//set the errorhandler for handling validation errors
validator.setErrorHandler(validationErrorHandler);

//validate the XML instance
validator.validate(xmlsource);

在《Validation when parsing》一节中，我们得到的 parser 每次运行时都要解析一次 schema，如果需要重复解析同一个 schema 的多个 XML 实例时，性能将极低。
使用本节所介绍的 JAXP 1.3 的 validation APIs，我们只需要解析一次 schema 然后将其缓存起来多次使用，可极大提升效率。

SAXParserFactory spf = SAXParserFactory.newInstance();
spf.setSchema(schema);
SAXParser saxParser = spf.newSAXParser();
saxParser.parse(new File("instance.xml"), myHandler);

需注意的是不必设置 parser 的 validation 为 true，也不需要设置 schemaLanguage 或 schemaSource 属性。而且，混合使用 schemaLanguage(或 schemaSource) 属性和 schema 实例将导致 SAXException 异常。

注意事项：
a). SchemaFactory 不是线程安全的，所以多线程程序中尤其要注意
b). Schema 是线程安全的，且是immutable的，所以可以将其实例缓存以提升性能，可以在多个 parsers 间甚至多个线程间共享使用.
c). Validator 不是线程安全的

Validate a DOMSource or SAXSource against preparsed schema

有时我们有的并不是一个 File 而是一个 SAX 对象或者 DOM 对象(比如得到的已解析过的SOAP消息)，仍可以使用Validation APIs进行校验。

Document document = //DOM object
validator.validate(new DOMSource(document), new DOMResult());

参考资料：
1). Validating with XML Schema
2). Easy and Efficient XML Processing: Upgrade to JAXP 1.3

2010/08/15 -- 定制 xmlbeans 所生成的 package
2009/07/23 -- XML 中的 schemaLocation 属性究竟是什么意思？
2009/07/07 -- Which style of WSDL should I use? (reship)
2009/05/15 -- HIBERNATE－为DB2指定默认schema
2009/03/02 -- 关于 XML standalone 的解释

XML Schema 中 dateTime 类型的解释

javafuns — Mon, 18 Aug 2008 08:05:38 +0000

dateTime 类型的形式为：’-'? yyyy ‘-’ mm ‘-’ dd ‘T’ hh ‘:’ mm ‘:’ ss (‘.’ s+)? (zzzzzz)?，其中：

‘-’? yyyy 是一个4位或者更多位数的可使用负号的数字，表示年份；如果多于4位数字，则打头数字不能是0， ’0000′ 也是禁止的；同样需要注意的是+号也不允许使用;
剩下的 ‘-’ 是时间中各部分的分隔符;
第一个 mm 是一个2位数字，表示月份;
dd 是一个2位数字，表示日期;
‘T’ 是一个分隔符，指明后面是日期中的时间;
hh 是一个2位数字，表示小时；如果分钟和秒是 0，那么使用 ’24′ 是允许的, 这个如此表示的 dateTime 值马上转为下一天的值(the dateTime value so represented is the first instant of the following day);
‘:’ 是一个时间中各部分的分隔符;
第二个 mm 是一个2位数的数字，表示分钟数;
ss 是一个2位整数数字，表示完整的秒数;
‘.’ s+ (如果有) 表示秒数的小数部分;
zzzzzz (如果有) 表示时区 (如下面所描述的).

例如，2002-10-10T12:00:00-05:00 是 2002-10-10T17:00:00Z，比 2002-10-10T12:00:00Z 晚 5 个小时.

For further guidance on arithmetic with dateTimes and durations, see Adding durations to dateTimes (§E).

关于 TimeZone：

时区中的小时数上限是14，分钟数上限是59，除非小时数是 14，而分钟数必须是 0。

时区的形式是 ((‘+’ | ‘-’) hh ‘:’ mm) | ‘Z’，其中：

hh 是一个2位数字 (必要情况下打头数字是0)，表示小时数
mm 是一个2位数字，表示分钟数
‘+’ 指明是一个正的时间段
‘-’ 指明是一个负的时间段

‘+00:00′, ‘-00:00′, 和 ‘Z’ 都表示相同的 0 时区，即UTC; ‘Z’ 是它的规范表现方式.

当将一个时区加到一个 UTC dateTime 中，结果是该日期和时间“位于这个时区中”。例如，2002-10-10T12:00:00+05:00 是 2002-10-10T07:00:00Z，2002-10-10T00:00:00+05:00 是 2002-10-09T19:00:00Z.

2010/08/15 -- 定制 xmlbeans 所生成的 package
2010/08/04 -- A brief introduction of what is RDF
2009/10/21 -- Tutorial of SOAP with Attachments API for Java
2009/07/23 -- XML 中的 schemaLocation 属性究竟是什么意思？
2009/07/19 -- SMTP Transport Binding for SOAP

What’s New in WSDL 2.0

javafuns — Tue, 29 Jul 2008 14:28:03 +0000

原文：http://www.xml.com/pub/a/ws/2004/05/19/wsdl2.html?page=1

by Arulazi Dhesiaseelan
May 20, 2004

W3C 的 Web Services Description Working Group, Web Services Activity 的一个子组织, 已经为描述 web service 定义了一种语言, 也定义了与他们交互的可能方式. The WG 于 26 March 2004 发布了 WSDL 2.0 工作草稿. 这是 WSDL 进化史上的一个重要里程碑. 本文中, 我讨论了相对于 WSDL 1.1 规范所作出的修改以及其它对 web 服务描述语言的主要改进.

W3C WSDL 2.0 工作草稿

W3C 已经公布了下列核心工作草稿作为该工作组交付物一部分:

其它相关工作草稿包括需求和使用场景.

W3C XML Schema definition for WSDL 2.0 specification 可见于 http://www.w3.org/2003/11/wsdl/.

The editor’s copies of these documents provide updated information about the progress of these specifications.

Changes from the WSDL 1.1 Specification

WSDL 1.2 重命名为 WSDL 2.0 因为它相对 WSDL 1.1 有很大不同. 这其中的一些改变包括:

进一步加强了 WSDL 的语义. 这是在 WSDL 2.0 中要求 targetNamespace 是 definitions element 的一个必需属性的原因之一.
去掉了 message 结构.
不再支持操作重载.
PortTypes 重命名为 interfaces. 支持 interface 使用 extends 属性实现继承.
Ports 重命名为 endpoints.

WSDL 2.0 Conceptual Model

一个 web service 的描述可以模型化为两部分. 在抽象部分里, WSDL 通过类型系统描述了 web service 发送和接收的消息, 典型的是使用 W3C XML Schema. Message exchange patterns define the sequence and cardinality of messages. operation 将 message exchange patterns 与一个或多个 messages 关联到一起. interface 在传输和报文中立基础上聚合这些 operations.

在描述的具体部分, bindings 指定了 interfaces 的传输方式和报文格式. service endpoint 将网络地址和 binding 关联在一起. 最后, service 将实现了共同的 interface 的 endpoints 聚合起来. Figure 1 展示了概念性的 WSDL 组件模型.

Figure 1: WSDL Conceptual model

WSDL Components

WSDL 提供了一组组件和它们的属性用于描述 web services. Listing 2 展示了使用 WSDL 2.0 描述的骨架. 下一章节给出每个组件的简要概览.


 ?
[ |  ] *
 ?
[ |  |  ] *

Listing 2: WSDL 2.0 Skeleton

Definitions

definitions element 是 WSDL 文档的根. 它作为一个容器容纳关于 service 及其属性的所有必要信息. Figure 2 展示了 definitions element 的 schema. definitions element 的 targetNamespace 属性是必需的. namespace 能够直接或间接定义 WSDL 的语义. definitions element 也可以有其它可选属性指向其它各种 namespaces, 可用在 WSDL 文档中.

Figure 2: definitions schema

Include

include element 有助于模块化 web service 描述, 这样, 来自同一目标命名空间的各 service 定义组件可存放于不同的 WSDL 文档中, 这非常有利于在多个 web service 描述间使用和共享. location 属性是强制要有的, 用于指定 WSDL 文档的地址. 在被包含 WSDL 中的目标命名空间的实际值必须匹配主(including) WSDL 中 definitions element 的目标命名空间. Figure 3 展示了 include element 的 XML schema.

Figure 3: include schema

Import

import element 非常类似于 include element, 除了被 imported WSDL 必须是在不同的 target namespaces. import element 的 namespace attribute 是强制性的, 但 location attribute 是可选的. Figure 4 展示了 import element 的 XML schema.

Figure 4: import schema

Types

types element 定义了交换消息使用的数据类型. WSDL 使用 W3C XML Schema 作为首选 schema 语言. 它也支持其它系统如 DTDs and RELAX NG. Schemas 可以在 WSDL 文档的 types element 中进行导入或者嵌入(importing or embedding). 导入是使用 xs:import, 嵌入是使用 xs:schema. 被导入或者嵌入的 schema components 可使用 QName 进行引用. Figure 5 展示了 types element 的 XML schema.

Figure 5: types schema

Interface

一个 interface element 封装了一组抽象操作和抽象消息. 它可以(也可以不)继承一个或多个其它 interfaces. Interfaces 在其它组件如 bindings 中使用 QName 进行引用. interface operation element 具有 name 和 pattern 属性, 都是必需的, 但 style 是可选属性. Figure 6 展示了 interface element 的 schema. Features 定义了在通信双方间进行消息交换相关的功能, 这可能包括可靠性, 安全, 相关性, 和路由. Property 用于控制 feature 的行为. It has a set of possible and permissible values specified by references to a schema description. These values can be shared among features.

Figure 6: interface schema

Binding

binding element 定义了底层传输方式和消息的报文格式. WSDL 中的每个 binding 都引用一个 interface. 所有在该 interface 中定义的 operations 必须在 binding 进行绑定. 在 service 中, endpoint 引用 binding. Both endpoints and bindings are modeled to support flexibility and location transparency. 多个具有不同网络地址的 endpoints 仍可以共享相同协议的 binding. WSDL 2.0 Bindings 规范定义了 binding 协议和消息格式的扩展, 例如 SOAP, HTTP and MIME. Figure 7 展示了 binding element 的 XML schema.

Figure 7: binding schema

Service

一个 service element 描述一组 endpoints, 每个 endpoint 都为一个 binding 引用一个单一网络地址. 所有其它协议特定信息都包含在 binding. Service 可以使用 QName 进行引用. service element 具有一个 name 和 interface, 都是必需的属性. Figure 8 展示了 service element 的 XML schema.

Figure 8: service schema

WSDL Message Exchange Patterns

Message exchange patterns define the sequence and cardinality of messages within an operation. Several types of message patterns are defined in the â€œPart 2: Message Patternsâ€ of the WSDL 2.0 specifications. WSDL message exchange patterns uses fault generation rules to indicate the occurrence of faults. Message exchange may be terminated if fault generation happens regardless of standard rule sets. The following standard rule set outlines the behavior of fault generation.

Fault Replaces Messages
Message Triggers Fault
No Faults

Figure 9 shows the various message exchange patterns with their fault reference rules.

Figure 9: WSDL Message Exchange Patterns

Stock Quote Service Description in WSDL 1.1 & WSDL 2.0

在这一节, 你可以预览到一个用 WSDL 1.1 和 WSDL 2.0 描述的简单的股票报价服务(stock quote service). Listing 2 展示了用于描述股票报价服务的 XML schema types. Listing 3 and 4 分别展示了用 WSDL 1.1 和 WSDL 2.0 描述的股票报价服务接口定义. Listing 5 and 6 分别展示了 WSDL 1.1 和 WSDL 2.0 的股票报价服务实现的定义.

http://example.com/stockquote/stockquoteV11.xsd


xmlns="http://www.w3.org/2000/10/XMLSchema">

http://example.com/stockquote/stockquoteV20.xsd


xmlns="http://www.w3.org/2001/XMLSchema">

Listing 2: XML Schema definition for Stock Quote Service

http://example.com/stockquote/stockquoteV11.wsdl


    xmlns:tns="http://example.com/stockquote/definitions"
        xmlns:xsd1="http://example.com/stockquote/schemas"
        xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
         xmlns="http://schemas.xmlsoap.org/wsdl/">

Listing 3: WSDL 1.1 Interface definition for Stock Quote Service

http://example.com/stockquote/stockquoteV20.wsdl


xmlns:tns="http://example.com/stockquote/definitions"
        xmlns:xsd1="http://example.com/stockquote/schemas"
        xmlns:soap="http://www.w3.org/2003/11/wsdl/soap12"
        xmlns="http://www.w3.org/2003/11/wsdl">

Listing 4: WSDL 2.0 Interface definition for Stock Quote Service

http://example.com/stockquote/stockquoteserviceV11.wsdl


xmlns:tns="http://example.com/stockquote/service"
          xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
          xmlns:defs="http://example.com/stockquote/definitions"
          xmlns="http://schemas.xmlsoap.org/wsdl/">

    
    
        
        
            
            
                
            
            
                
            
        
    
    
        My first service

Listing 5: WSDL 1.1 Implementation definition for Stock Quote Service

http://example.com/stockquote/stockquoteserviceV20.wsdl


xmlns:tns="http://example.com/stockquote/service"
          xmlns:wsoap="http://www.w3.org/2003/11/wsdl/soap12"
          xmlns:defs="http://example.com/stockquote/definitions"
          xmlns="http://www.w3.org/2003/11/wsdl">

    

    
        
        
           
           
               
           
           
               
           
        
    
    
        My stock quote service

Listing 6: WSDL 2.0 Implementation definition for Stock Quote Service

Summary

在本文中, 我解释了 WSDL 2.0 规范的工作草稿的一些详细情况. 该工作组正在讨论是否向现有规范中增加更多的特性以便提供高度灵活性和强壮的语言来描述 web services. 这些特性包括 web service 引用(references), 版本化(versioning), 属性(attributes), 和 compositors. 除了这些新特性, further refinements are made to the existing specification. 开发者社区希望在不久的将来能有一个更稳定的 WSDL 2.0 规范的版本.

Resources

2009/07/07 -- Which style of WSDL should I use? (reship)
2009/07/19 -- SMTP Transport Binding for SOAP
2010/08/15 -- 定制 xmlbeans 所生成的 package
2009/10/21 -- Tutorial of SOAP with Attachments API for Java
2009/07/23 -- XML 中的 schemaLocation 属性究竟是什么意思？

Open your thoughts » XML

定制 xmlbeans 所生成的 package

Related Posts:

A brief introduction of what is RDF

Related Posts:

Tutorial of SOAP with Attachments API for Java

Related Posts:

XML 中的 schemaLocation 属性究竟是什么意思？

Related Posts:

SMTP Transport Binding for SOAP

Resources:

Related Posts:

Which style of WSDL should I use? (reship)

Introduction

RPC/encoded

A note about prefixes and namespaces

Strengths

Weaknesses

Related Posts:

关于 XML standalone 的解释

Related Posts:

Java 程序中如何对 XML 文档进行验证？

Table Of Content

Introduction

Validation when parsing

Validation against preparsed schema

Validate a DOMSource or SAXSource against preparsed schema

Related Posts:

XML Schema 中 dateTime 类型的解释

Related Posts:

What’s New in WSDL 2.0

W3C WSDL 2.0 工作草稿

Changes from the WSDL 1.1 Specification

WSDL 2.0 Conceptual Model

WSDL Components

Definitions

Include

Import

Types

Interface

Binding

Service

WSDL Message Exchange Patterns

Stock Quote Service Description in WSDL 1.1 & WSDL 2.0

Summary

Resources

Related Posts: