com.opsmatters.newrelic.api.NewRelicPartnerApi Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of newrelic-api Show documentation

Java client library for the New Relic REST APIs built using Jersey and Gson. The library includes over 110 operations across all of the available 35 New Relic services. It can be used by applications to automate the configuration of New Relic Monitoring, Alerting and Dashboards, but can also be used for extracting incident and metric data, executing Insights queries, and uploading plugin metrics.

There is a newer version: 1.0.12

Show newest version

/*
 * Copyright 2018 Gerald Curley
 *
 * 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.opsmatters.newrelic.api;

import java.util.logging.Logger;
import com.opsmatters.newrelic.api.httpclient.ApiKeyHttpClientProvider;
import com.opsmatters.newrelic.api.httpclient.HttpClientProvider;
import com.opsmatters.newrelic.api.services.PartnerAccountService;
import com.opsmatters.newrelic.api.services.PartnerUserService;
import com.opsmatters.newrelic.api.services.PartnerSubscriptionService;

/**
 * Client used to invoke New Relic operations using the Partner API.
 * 
 * @author Gerald Curley (opsmatters)
 */
public class NewRelicPartnerApi extends NewRelicClient
{
    private static final Logger logger = Logger.getLogger(NewRelicPartnerApi.class.getName());
 
    /**
     * The default hostname for New Relic Partner API.
     */
    public static final String DEFAULT_HOST = "rpm.newrelic.com";

    /**
     * Default constructor.
     */
    public NewRelicPartnerApi()
    {
        setHostname(DEFAULT_HOST);
    }
    
    /**
     * Constructor that takes a hostname, port and provider.
     * @param hostname The hostname of the server
     * @param port The port of the server
     * @param provider The HTTP client provider
     */
    public NewRelicPartnerApi(String hostname, int port, HttpClientProvider provider)
    {    
        super(hostname, port, provider);
    }
    
    /**
     * Sets the name of the host to connect to.
     * 
     * The default hostname is "rpm.newrelic.com".
     * @param hostname The name of the host
     */
    public void setHostname(String hostname)
    {
        super.setHostname(hostname);
    }

    /**
     * Returns the uri prefix for resources used by the client.
     * 

     * Defaults to "/api" for Partner API.
     * @return The uri prefix for the client
     */
    @Override
    public String getUriPrefix()
    {
        return "/api";
    }

    /**
     * Returns the operations related to Partner accounts.
     * @return The Partner account service
     */
    public PartnerAccountService accounts()
    {
        checkInitialize();
        return new PartnerAccountService(httpContext, this);
    }

    /**
     * Returns the operations related to Partner users.
     * @return The Partner user service
     */
    public PartnerUserService users()
    {
        checkInitialize();
        return new PartnerUserService(httpContext, this);
    }

    /**
     * Returns the operations related to Partner subscriptions.
     * @return The Partner subscription service
     */
    public PartnerSubscriptionService subscriptions()
    {
        checkInitialize();
        return new PartnerSubscriptionService(httpContext, this);
    }

    /**
     * Returns a builder for the NewRelicPartnerApi.
     * @return The builder instance.
     */
    public static Builder builder()
    {
        return new Builder();
    }

    /**
     * Builder to make NewRelicPartnerApi construction easier.
     */
    public static class Builder
    {
        private String hostname = DEFAULT_HOST;
        private int port = DEFAULT_PORT;
        private HttpClientProvider provider = new ApiKeyHttpClientProvider("");

        /**
         * Default constructor.
         */
        public Builder()
        {
            hostname(DEFAULT_HOST);
        }

        /**
         * Sets the name of the host to connect to.
         * 

         * The default hostname is "rpm.newrelic.com".
         * @param hostname The name of the host
         * @return This object
         */
        public Builder hostname(String hostname)
        {
            this.hostname = hostname;
            return this;
        }

        /**
         * Sets the port of the host to connect to.
         * 
         * The default port is 443.
         * @param port The port of the host
         * @return This object
         */
        public Builder port(int port)
        {
            this.port = port;
            return this;
        }

        /**
         * Sets the API key used to authenticate the connection.
         * @param key The API key
         * @return This object
         */
        public Builder apiKey(String key)
        {
            this.provider = new ApiKeyHttpClientProvider(key);
            return this;
        }

        /**
         * Returns the configured Partner API client instance
         * @return The Partner API client instance
         */
        public NewRelicPartnerApi build()
        {
            return new NewRelicPartnerApi(hostname, port, provider);
        }
    }
}