com.mongodb.MongoURI Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of mongodb-driver Show documentation
The MongoDB Driver uber-artifact that combines mongodb-driver-sync and the legacy driver
There is a newer version: 3.12.14
/*
 * Copyright 2008-present MongoDB, Inc.
 *
 * Licensed 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.
 */

package com.mongodb;

import com.mongodb.lang.Nullable;

import java.util.List;


/**
 * Represents a URI which can be used to create a Mongo instance. The URI
 * describes the hosts to be used and options.
 *
 * This class has been superseded by {@code MongoClientURI}, and may be removed in a future release.
 *
 * @see MongoClientURI
 * @deprecated Replaced by {@link MongoClientURI}
 */
@Deprecated
public class MongoURI {

    /**
     * The prefix for mongodb URIs.
     */
    public static final String MONGODB_PREFIX = "mongodb://";
    private final MongoClientURI proxied;

    @SuppressWarnings("deprecation")
    private final MongoOptions options;

    /**
     * Creates a MongoURI from a string.
     *
     * @param uri the URI
     * @mongodb.driver.manual reference/connection-string Connection String URI Format
     * @deprecated Replaced by {@link MongoClientURI#MongoClientURI(String)}
     */
    @SuppressWarnings("deprecation")
    @Deprecated
    public MongoURI(final String uri) {
        this.proxied = new MongoClientURI(uri, MongoClientOptions.builder()
                                                                 .connectionsPerHost(10)
                                                                 .writeConcern(WriteConcern.UNACKNOWLEDGED)
        );
        options = new MongoOptions(proxied.getOptions());
    }

    /**
     * Create a new MongoURI from a MongoClientURI.  This class is deprecated, use {@link com.mongodb.MongoClientURI}.
     *
     * @param proxied the MongoClientURI to wrap with this deprecated class. * @deprecated Replaced by {@link MongoClientURI})
     */
    @SuppressWarnings("deprecation")
    @Deprecated
    public MongoURI(final MongoClientURI proxied) {
        this.proxied = proxied;
        options = new MongoOptions(proxied.getOptions());
    }

    // ---------------------------------

    /**
     * Gets the username.
     *
     * @return the username
     */
    @Nullable
    public String getUsername() {
        return proxied.getUsername();
    }

    /**
     * Gets the password.
     *
     * @return the password
     */
    @Nullable
    public char[] getPassword() {
        return proxied.getPassword();
    }

    /**
     * Gets the list of hosts.
     *
     * @return the list of hosts
     */
    public List getHosts() {
        return proxied.getHosts();
    }

    /**
     * Gets the database name.
     *
     * @return the database name
     */
    @Nullable
    public String getDatabase() {
        return proxied.getDatabase();
    }

    /**
     * Gets the collection name.
     *
     * @return the collection name
     */
    @Nullable
    public String getCollection() {
        return proxied.getCollection();
    }

    /**
     * Gets the credentials.
     *
     * @since 2.11.0
     * @return the MongoCredential for conneting to MongoDB servers.
     */
    @Nullable
    public MongoCredential getCredentials() {
        return proxied.getCredentials();
    }

    /**
     * Gets the options. This method will return the same instance of {@code MongoOptions} for every call, so it's possible to mutate the
     * returned instance to change the defaults.
     *
     * @return the mongo options
     */
    @SuppressWarnings("deprecation")
    public MongoOptions getOptions() {
        return options;
    }

    /**
     * Creates a Mongo instance based on the URI.
     *
     * @return a new Mongo instance.  There is no caching, so each call will create a new instance, each of which must be closed manually.
     * @throws MongoException if there's a failure
     */
    @SuppressWarnings("deprecation")
    public Mongo connect() {
        // Note: we can't change this to new MongoClient(this) as that would silently change the default write concern.
        return new Mongo(this);
    }

    /**
     * Returns the DB object from a newly created Mongo instance based on this URI.
     *
     * @return the database specified in the URI.  This will implicitly create a new Mongo instance, which must be closed manually.
     * @throws MongoException if there's a failure
     */
    public DB connectDB() {
        return connect().getDB(getDatabaseNonNull());
    }

    /**
     * Returns the URI's DB object from a given Mongo instance.
     *
     * @param mongo the Mongo instance to get the database from.
     * @return the database specified in this URI
     */
    @SuppressWarnings("deprecation")
    public DB connectDB(final Mongo mongo) {
        return mongo.getDB(getDatabaseNonNull());
    }

    /**
     * Returns the URI's Collection from a given DB object.
     *
     * @param db the database to get the collection from
     * @return the collection specified in this URI
     */
    public DBCollection connectCollection(final DB db) {
        return db.getCollection(getCollectionNonNull());
    }

    /**
     * Returns the URI's Collection from a given Mongo instance
     *
     * @param mongo the mongo instance to get the collection from
     * @return the collection specified in this URI
     */
    @SuppressWarnings("deprecation")
    public DBCollection connectCollection(final Mongo mongo) {
        return connectDB(mongo).getCollection(getCollectionNonNull());
    }

    @Override
    public String toString() {
        return proxied.toString();
    }

    MongoClientURI toClientURI() {
        return proxied;
    }

    private String getDatabaseNonNull() {
        String database = getDatabase();
        if (database == null) {
            throw new MongoClientException("Database name can not be null in this context");
        }
        return database;
    }

    private String getCollectionNonNull() {
        String collection = getCollection();
        if (collection == null) {
            throw new MongoClientException("Collection name can not be null in this context");
        }
        return collection;
    }

}