src/share/jaxws_classes/com/oracle/webservices/internal/api/databinding/WSDLResolver.java

Tue, 23 Apr 2013 18:33:20 -0700

author
katleman
date
Tue, 23 Apr 2013 18:33:20 -0700
changeset 374
72e03566f0a6
parent 368
0989ad8c0860
child 637
9c07ef4934dd
permissions
-rw-r--r--

8012643: JDK8 b86 source with GPL header errors
Reviewed-by: dholmes, alanb

alanb@368 1 /*
katleman@374 2 * Copyright (c) 2012, Oracle and/or its affiliates. All rights reserved.
katleman@374 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
alanb@368 4 *
katleman@374 5 * This code is free software; you can redistribute it and/or modify it
katleman@374 6 * under the terms of the GNU General Public License version 2 only, as
katleman@374 7 * published by the Free Software Foundation. Oracle designates this
katleman@374 8 * particular file as subject to the "Classpath" exception as provided
katleman@374 9 * by Oracle in the LICENSE file that accompanied this code.
alanb@368 10 *
katleman@374 11 * This code is distributed in the hope that it will be useful, but WITHOUT
katleman@374 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
katleman@374 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
katleman@374 14 * version 2 for more details (a copy is included in the LICENSE file that
katleman@374 15 * accompanied this code).
alanb@368 16 *
katleman@374 17 * You should have received a copy of the GNU General Public License version
katleman@374 18 * 2 along with this work; if not, write to the Free Software Foundation,
katleman@374 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
alanb@368 20 *
katleman@374 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
katleman@374 22 * or visit www.oracle.com if you need additional information or have any
katleman@374 23 * questions.
alanb@368 24 */
alanb@368 25
alanb@368 26 package com.oracle.webservices.internal.api.databinding;
alanb@368 27
alanb@368 28 import javax.xml.transform.Result;
alanb@368 29 import javax.xml.ws.Holder;
alanb@368 30
alanb@368 31 /**
alanb@368 32 * WSDLResolver is used by WSDLGenerator while generating WSDL and its associated
alanb@368 33 * documents. It is used to control what documents need to be generated and what
alanb@368 34 * documents need to be picked from metadata. If endpont's document metadata
alanb@368 35 * already contains some documents, their systemids may be used for wsdl:import,
alanb@368 36 * and schema:import. The suggested filenames are relative urls(for e.g: EchoSchema1.xsd)
alanb@368 37 * The Result object systemids are also relative urls(for e.g: AbsWsdl.wsdl).
alanb@368 38 *
alanb@368 39 * @author Jitendra Kotamraju
alanb@368 40 */
alanb@368 41 public interface WSDLResolver {
alanb@368 42 /**
alanb@368 43 * Create a Result object into which concrete WSDL is to be generated.
alanb@368 44 *
alanb@368 45 * @return Result for the concrete WSDL
alanb@368 46 */
alanb@368 47 public Result getWSDL(String suggestedFilename);
alanb@368 48
alanb@368 49 /**
alanb@368 50 * Create a Result object into which abstract WSDL is to be generated. If the the
alanb@368 51 * abstract WSDL is already in metadata, it is not generated.
alanb@368 52 *
alanb@368 53 * Update filename if the suggested filename need to be changed in wsdl:import.
alanb@368 54 * This needs to be done if the metadata contains abstract WSDL, and that systemid
alanb@368 55 * needs to be reflected in concrete WSDL's wsdl:import
alanb@368 56 *
alanb@368 57 * @return null if abstract WSDL need not be generated
alanb@368 58 */
alanb@368 59 public Result getAbstractWSDL(Holder<String> filename);
alanb@368 60
alanb@368 61 /**
alanb@368 62 * Create a Result object into which schema doc is to be generated. Typically if
alanb@368 63 * there is a schema doc for namespace in metadata, then it is not generated.
alanb@368 64 *
alanb@368 65 * Update filename if the suggested filename need to be changed in xsd:import. This
alanb@368 66 * needs to be done if the metadata contains the document, and that systemid
alanb@368 67 * needs to be reflected in some other document's xsd:import
alanb@368 68 *
alanb@368 69 * @return null if schema need not be generated
alanb@368 70 */
alanb@368 71 public Result getSchemaOutput(String namespace, Holder<String> filename);
alanb@368 72
alanb@368 73 }

mercurial