jdk8-mips64-public/jaxws: src/share/jaxws_classes/javax/xml/bind/SchemaOutputResolver.java@0989ad8c0860 (annotated)

src/share/jaxws_classes/javax/xml/bind/SchemaOutputResolver.java@0989ad8c0860 (annotated)

src/share/jaxws_classes/javax/xml/bind/SchemaOutputResolver.java

Tue, 09 Apr 2013 14:51:13 +0100

author: alanb
date: Tue, 09 Apr 2013 14:51:13 +0100
changeset 368: 0989ad8c0860
parent 286: f50545b5e2f1
child 397: b99d7e355d4b
permissions: -rw-r--r--

8010393: Update JAX-WS RI to 2.2.9-b12941
Reviewed-by: alanb, erikj
Contributed-by: miroslav.kos@oracle.com, martin.grebac@oracle.com

 /*
  * Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Oracle designates this
  * particular file as subject to the "Classpath" exception as provided
  * by Oracle in the LICENSE file that accompanied this code.
  *
  * This code is distributed in the hope that it will be useful, but WITHOUT
  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  * version 2 for more details (a copy is included in the LICENSE file that
  * accompanied this code).
  *
  * You should have received a copy of the GNU General Public License version
  * 2 along with this work; if not, write to the Free Software Foundation,
  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  *
  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  * or visit www.oracle.com if you need additional information or have any
  * questions.
  */
 package javax.xml.bind;
 import javax.xml.transform.Result;
 import java.io.IOException;
 /**
  * Controls where a JAXB implementation puts the generates
  * schema files.
  *
  * <p>
  * An implementation of this abstract class has to be provided by the calling
  * application to generate schemas.
  *
  * <p>
  * This is a class, not an interface so as to allow future versions to evolve
  * without breaking the compatibility.
  *
  * @author
  *     Kohsuke Kawaguchi (kohsuke.kawaguchi@sun.com)
  */
 public abstract class SchemaOutputResolver {
     /**
      * Decides where the schema file (of the given namespace URI)
      * will be written, and return it as a {@link Result} object.
      *
      * <p>
      * This method is called only once for any given namespace.
      * IOW, all the components in one namespace is always written
      * into the same schema document.
      *
      * @param namespaceUri
      *      The namespace URI that the schema declares.
      *      Can be the empty string, but never be null.
      * @param suggestedFileName
      *      A JAXB implementation generates an unique file name (like "schema1.xsd")
      *      for the convenience of the callee. This name can be
      *      used for the file name of the schema, or the callee can just
      *      ignore this name and come up with its own name.
      *      This is just a hint.
      *
      * @return
      *      a {@link Result} object that encapsulates the actual destination
      *      of the schema.
      *
      *      If the {@link Result} object has a system ID, it must be an
      *      absolute system ID. Those system IDs are relativized by the caller and used
      *      for &lt;xs:import> statements.
      *
      *      If the {@link Result} object does not have a system ID, a schema
      *      for the namespace URI is generated but it won't be explicitly
      *      &lt;xs:import>ed from other schemas.
      *
      *      If {@code null} is returned, the schema generation for this
      *      namespace URI will be skipped.
      */
     public abstract Result createOutput( String namespaceUri, String suggestedFileName ) throws IOException;
 }

Mercurial > jdk8-mips64-public > jaxws / annotate

src/share/jaxws_classes/javax/xml/bind/SchemaOutputResolver.java@0989ad8c0860 (annotated)

src/share/jaxws_classes/javax/xml/bind/SchemaOutputResolver.java