net.spy.memcached.config.NodeEndPoint Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of elasticache-java-cluster-client Show documentation

Amazon ElastiCache Cluster Client is an enhanced Java library to connect to ElastiCache clusters. This client library has been built upon Spymemcached and is released under the Amazon Software License.

There is a newer version: 1.2.2

Show newest version

/**
 * Copyright (C) 2012-2012 Amazon.com, Inc. or its affiliates. All Rights Reserved. 
 *
 * Licensed under the Amazon Software License (the "License"). You may not use this 
 * file except in compliance with the License. A copy of the License is located at
 *  http://aws.amazon.com/asl/
 * or in the "license" file accompanying this file. This file is distributed on 
 * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, express or
 * implied. See the License for the specific language governing permissions and 
 * limitations under the License. 
 */
package net.spy.memcached.config;

import java.net.InetAddress;
import java.net.InetSocketAddress;
import java.net.UnknownHostException;

/**
 * NodeEndPoint captures the information needed to connect to a cache node.
 * Both hostName and ipAddress to capture the latest information instead of relying entirely on the DNS servers.
 *
 */
public class NodeEndPoint {
  private final String hostName;
  private final String ipAddress;
  private final int port;

  /**
   * Immutable instance with a hostname, ip address, and port.
   * 
   * @param hostName
   *            hostname (ex. foo.bar.com)
   * @param ipAddress
   *            string form of IP address (ex. 10.10.1.1). It is expected that
   *            this IP address is valid.
   * @param port
   *            port (ex. 11211)
   */
  public NodeEndPoint(final String hostName, final String ipAddress, final int port) {
      this.hostName = hostName != null ? hostName.trim() : null;
      this.ipAddress = ipAddress != null ? ipAddress.trim() : null;
      this.port = port;
  }

  /**
   * Immutable instance, without an IP address.
   * 
   * @param hostName
   *            hostname (ex. foo.bar.com).
   * @param port
   *            port (ex. 11211)
   */
  public NodeEndPoint(final String hostName, final int port) {
    this(hostName, null, port);
  }

  /**
   * @return hostname (ex. foo.bar.com)
   */
  public String getHostName() {
      return hostName;
  }

  /**
   * @return IP address, in textual form (ex. 10.1.10.1)
   */
  public String getIpAddress() {
      return ipAddress;
  }

  /**
   * @return port (ex. 11211)
   */
  public int getPort() {
      return port;
  }

  public InetSocketAddress getInetSocketAddress(){
	  return getInetSocketAddress(false);
  }
  
  public InetSocketAddress getInetSocketAddress(boolean reresolve){
    if(reresolve == true || ipAddress == null || ipAddress.trim().equals("")){
      return new InetSocketAddress(hostName, port);
    } else {
      try {
        return new InetSocketAddress(InetAddress.getByName(ipAddress) , port);
      } catch (UnknownHostException e) {
        throw new IllegalArgumentException("Invalid server with hostName:" + hostName + ", IpAddress:" + ipAddress);
      }
    }
  }
  
  /**
   * copy one object to another.
   */
  public static NodeEndPoint copy(final NodeEndPoint other) {
      return new NodeEndPoint(other.getHostName(), other.getIpAddress(), other.getPort());
  }
  
  @Override
  public String toString(){
    StringBuilder buffer = new StringBuilder("NodeEndPoint - ");
    buffer.append("HostName:" + hostName);
    buffer.append(" IpAddress:" + ipAddress);
    buffer.append(" Port:" + port);
    
    return buffer.toString();
  }

}