src/share/jaf_classes/javax/activation/URLDataSource.java

Wed, 27 Apr 2016 01:27:09 +0800

author
aoqi
date
Wed, 27 Apr 2016 01:27:09 +0800
changeset 0
373ffda63c9a
permissions
-rw-r--r--

Initial load
http://hg.openjdk.java.net/jdk8u/jdk8u/jaxws/
changeset: 657:d47a47f961ee
tag: jdk8u25-b17

aoqi@0 1 /*
aoqi@0 2 * Copyright (c) 1997, 2005, Oracle and/or its affiliates. All rights reserved.
aoqi@0 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
aoqi@0 4 *
aoqi@0 5 * This code is free software; you can redistribute it and/or modify it
aoqi@0 6 * under the terms of the GNU General Public License version 2 only, as
aoqi@0 7 * published by the Free Software Foundation. Oracle designates this
aoqi@0 8 * particular file as subject to the "Classpath" exception as provided
aoqi@0 9 * by Oracle in the LICENSE file that accompanied this code.
aoqi@0 10 *
aoqi@0 11 * This code is distributed in the hope that it will be useful, but WITHOUT
aoqi@0 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
aoqi@0 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
aoqi@0 14 * version 2 for more details (a copy is included in the LICENSE file that
aoqi@0 15 * accompanied this code).
aoqi@0 16 *
aoqi@0 17 * You should have received a copy of the GNU General Public License version
aoqi@0 18 * 2 along with this work; if not, write to the Free Software Foundation,
aoqi@0 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
aoqi@0 20 *
aoqi@0 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
aoqi@0 22 * or visit www.oracle.com if you need additional information or have any
aoqi@0 23 * questions.
aoqi@0 24 */
aoqi@0 25
aoqi@0 26 package javax.activation;
aoqi@0 27
aoqi@0 28 import java.net.URL;
aoqi@0 29 import java.net.URLConnection;
aoqi@0 30 import java.io.InputStream;
aoqi@0 31 import java.io.OutputStream;
aoqi@0 32 import java.io.IOException;
aoqi@0 33
aoqi@0 34 /**
aoqi@0 35 * The URLDataSource class provides an object that wraps a <code>URL</code>
aoqi@0 36 * object in a DataSource interface. URLDataSource simplifies the handling
aoqi@0 37 * of data described by URLs within the JavaBeans Activation Framework
aoqi@0 38 * because this class can be used to create new DataHandlers. <i>NOTE: The
aoqi@0 39 * DataHandler object creates a URLDataSource internally,
aoqi@0 40 * when it is constructed with a URL.</i>
aoqi@0 41 *
aoqi@0 42 * @see javax.activation.DataSource
aoqi@0 43 * @see javax.activation.DataHandler
aoqi@0 44 *
aoqi@0 45 * @since 1.6
aoqi@0 46 */
aoqi@0 47 public class URLDataSource implements DataSource {
aoqi@0 48 private URL url = null;
aoqi@0 49 private URLConnection url_conn = null;
aoqi@0 50
aoqi@0 51 /**
aoqi@0 52 * URLDataSource constructor. The URLDataSource class will
aoqi@0 53 * not open a connection to the URL until a method requiring it
aoqi@0 54 * to do so is called.
aoqi@0 55 *
aoqi@0 56 * @param url The URL to be encapsulated in this object.
aoqi@0 57 */
aoqi@0 58 public URLDataSource(URL url) {
aoqi@0 59 this.url = url;
aoqi@0 60 }
aoqi@0 61
aoqi@0 62 /**
aoqi@0 63 * Returns the value of the URL content-type header field.
aoqi@0 64 * It calls the URL's <code>URLConnection.getContentType</code> method
aoqi@0 65 * after retrieving a URLConnection object.
aoqi@0 66 * <i>Note: this method attempts to call the <code>openConnection</code>
aoqi@0 67 * method on the URL. If this method fails, or if a content type is not
aoqi@0 68 * returned from the URLConnection, getContentType returns
aoqi@0 69 * "application/octet-stream" as the content type.</i>
aoqi@0 70 *
aoqi@0 71 * @return the content type.
aoqi@0 72 */
aoqi@0 73 public String getContentType() {
aoqi@0 74 String type = null;
aoqi@0 75
aoqi@0 76 try {
aoqi@0 77 if (url_conn == null)
aoqi@0 78 url_conn = url.openConnection();
aoqi@0 79 } catch (IOException e) { }
aoqi@0 80
aoqi@0 81 if (url_conn != null)
aoqi@0 82 type = url_conn.getContentType();
aoqi@0 83
aoqi@0 84 if (type == null)
aoqi@0 85 type = "application/octet-stream";
aoqi@0 86
aoqi@0 87 return type;
aoqi@0 88 }
aoqi@0 89
aoqi@0 90 /**
aoqi@0 91 * Calls the <code>getFile</code> method on the URL used to
aoqi@0 92 * instantiate the object.
aoqi@0 93 *
aoqi@0 94 * @return the result of calling the URL's getFile method.
aoqi@0 95 */
aoqi@0 96 public String getName() {
aoqi@0 97 return url.getFile();
aoqi@0 98 }
aoqi@0 99
aoqi@0 100 /**
aoqi@0 101 * The getInputStream method from the URL. Calls the
aoqi@0 102 * <code>openStream</code> method on the URL.
aoqi@0 103 *
aoqi@0 104 * @return the InputStream.
aoqi@0 105 */
aoqi@0 106 public InputStream getInputStream() throws IOException {
aoqi@0 107 return url.openStream();
aoqi@0 108 }
aoqi@0 109
aoqi@0 110 /**
aoqi@0 111 * The getOutputStream method from the URL. First an attempt is
aoqi@0 112 * made to get the URLConnection object for the URL. If that
aoqi@0 113 * succeeds, the getOutputStream method on the URLConnection
aoqi@0 114 * is returned.
aoqi@0 115 *
aoqi@0 116 * @return the OutputStream.
aoqi@0 117 */
aoqi@0 118 public OutputStream getOutputStream() throws IOException {
aoqi@0 119 // get the url connection if it is available
aoqi@0 120 url_conn = url.openConnection();
aoqi@0 121
aoqi@0 122 if (url_conn != null) {
aoqi@0 123 url_conn.setDoOutput(true);
aoqi@0 124 return url_conn.getOutputStream();
aoqi@0 125 } else
aoqi@0 126 return null;
aoqi@0 127 }
aoqi@0 128
aoqi@0 129 /**
aoqi@0 130 * Return the URL used to create this DataSource.
aoqi@0 131 *
aoqi@0 132 * @return The URL.
aoqi@0 133 */
aoqi@0 134 public URL getURL() {
aoqi@0 135 return url;
aoqi@0 136 }
aoqi@0 137 }

mercurial