URL.h

Go to the documentation of this file.

/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef _DECAF_NET_URL_H_
#define _DECAF_NET_URL_H_

#include <decaf/util/Config.h>
#include <decaf/lang/String.h>

#include <decaf/io/InputStream.h>
#include <string>

namespace decaf {
namespace net {

    class URI;
    class URLImpl;
    class URLStreamHandler;
    class URLStreamHandlerFactory;
    class URLConnection;
    class Proxy;

    class DECAF_API URL {
    private:

        URLImpl* impl;

    public:

        URL(const decaf::lang::String& url);

        URL(const URL& context, const decaf::lang::String& spec);

        URL(const decaf::lang::String& protocol, const decaf::lang::String& host, int port,
            const decaf::lang::String& file, URLStreamHandler* handler);

        URL(const decaf::lang::String& protocol, const decaf::lang::String& host, const decaf::lang::String& file);

        URL(const decaf::lang::String& protocol, const decaf::lang::String& host, int port, const decaf::lang::String& file);

        URL(const URL& context, const decaf::lang::String& spec, URLStreamHandler* handler);

        virtual ~URL();

    public:

        bool equals(const URL& other) const;

        decaf::lang::String getAuthority() const;

        int getDefaultPort() const;

        decaf::lang::String getFile() const;

        decaf::lang::String getHost() const;

        decaf::lang::String getPath() const;

        decaf::lang::String getUserInfo() const;

        int getPort() const;

        decaf::lang::String getProtocol() const;

        decaf::lang::String getQuery() const;

        decaf::lang::String getRef() const;

        int hashCode() const;

        URLConnection* openConnection();

        URLConnection* openConnection(const Proxy* proxy);

        decaf::io::InputStream* openStream();

        bool sameFile(const URL& other) const;

        decaf::lang::String toExternalForm() const;

        std::string toString() const;

        URI toURI() const;

    public:

        static void setURLStreamHandlerFactory(URLStreamHandlerFactory* factory);

    private:

        void set(const decaf::lang::String& protocol, const decaf::lang::String& host, int port,
                 const decaf::lang::String& file, const decaf::lang::String& ref);

        void set(const decaf::lang::String& protocol, const decaf::lang::String& host, int port,
                 const decaf::lang::String& authority, const decaf::lang::String& userInfo,
                 const decaf::lang::String& path, const decaf::lang::String& query,
                 const decaf::lang::String& ref);

        URLStreamHandler* getURLStreamHandler() const;

    private:

        void initialize(const URL* context, const decaf::lang::String& theSpec, URLStreamHandler* handler);
        void initialize(const decaf::lang::String& protocol, const decaf::lang::String& host, int port,
                        const decaf::lang::String& file, URLStreamHandler* handler);


        friend class URLStreamHandler;

    };

}}

#endif /*_DECAF_NET_URL_H_*/