org.jclouds.dynect.v3.domain.rdata.SRVData Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of dynect Show documentation
jclouds components for DynECT Managed DNS
There is a newer version: 2.6.0
/*
 * 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.
 */
package org.jclouds.dynect.v3.domain.rdata;

import static com.google.common.base.Preconditions.checkArgument;
import static com.google.common.base.Preconditions.checkNotNull;

import java.beans.ConstructorProperties;
import java.util.Map;

import com.google.common.collect.ForwardingMap;
import com.google.common.collect.ImmutableMap;

/**
 * Corresponds to the binary representation of the {@code SRV} (Service) RData
 * 
 * Example
 * 
 *  * SRVData rdata = SRVData.builder()
 *                        .priority(0)
 *                        .weight(1)
 *                        .port(80)
 *                        .target("www.foo.com.").build()
 * 
 * 
 * @see RFC 2782
 */
public class SRVData extends ForwardingMap {
   private final int priority;
   private final int weight;
   private final int port;
   private final String target;
   
   @ConstructorProperties({ "priority", "weight", "port", "target" })
   private SRVData(int priority, int weight, int port, String target) {
      checkArgument(priority <= 0xFFFF, "priority must be 0-65535");
      this.priority = priority;
      checkArgument(weight <= 0xFFFF, "weight must be 0-65535");
      this.weight = weight;
      checkArgument(port <= 0xFFFF, "port must be 0-65535");
      this.port = port;
      this.target = checkNotNull(target, "target");
      this.delegate = ImmutableMap. builder()
            .put("priority", priority)
            .put("weight", weight)
            .put("port", port)
            .put("target", target)
            .build();
   }

   /**
    * The priority of this target host. A client MUST attempt to contact the
    * target host with the lowest-numbered priority it can reach; target hosts
    * with the same priority SHOULD be tried in an order defined by the weight
    * field.
    */
   public int getPriority() {
      return priority;
   }

   /**
    * The weight field specifies a relative weight for entries with the same
    * priority. Larger weights SHOULD be given a proportionately higher
    * probability of being selected.
    */
   public int getWeight() {
      return weight;
   }

   /**
    * The port on this target host of this service.
    */
   public int getPort() {
      return port;
   }

   /**
    * The domain name of the target host. There MUST be one or more address
    * records for this name, the name MUST NOT be an alias.
    */
   public String getTarget() {
      return target;
   }

   private final transient ImmutableMap delegate;

   protected Map delegate() {
      return delegate;
   }

   public static SRVData.Builder builder() {
      return new Builder();
   }

   public SRVData.Builder toBuilder() {
      return builder().from(this);
   }

   public static final class Builder {
      private int priority = -1;
      private int weight = -1;
      private int port = -1;
      private String target;

      /**
       * @see SRVData#getPriority()
       */
      public SRVData.Builder priority(int priority) {
         this.priority = priority;
         return this;
      }

      /**
       * @see SRVData#getWeight()
       */
      public SRVData.Builder weight(int weight) {
         this.weight = weight;
         return this;
      }

      /**
       * @see SRVData#getPort()
       */
      public SRVData.Builder port(int port) {
         this.port = port;
         return this;
      }

      /**
       * @see SRVData#getTarget()
       */
      public SRVData.Builder target(String target) {
         this.target = target;
         return this;
      }

      public SRVData build() {
         return new SRVData(priority, weight, port, target);
      }

      public SRVData.Builder from(SRVData in) {
         return this.priority(in.getPriority()).weight(in.getWeight()).port(in.getPort()).target(in.getTarget());
      }
   }
}