0N/A/*
2362N/A * Copyright (c) 1997, 2007, Oracle and/or its affiliates. All rights reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
0N/A * This code is free software; you can redistribute it and/or modify it
0N/A * under the terms of the GNU General Public License version 2 only, as
2362N/A * published by the Free Software Foundation. Oracle designates this
0N/A * particular file as subject to the "Classpath" exception as provided
2362N/A * by Oracle in the LICENSE file that accompanied this code.
0N/A *
0N/A * This code is distributed in the hope that it will be useful, but WITHOUT
0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A * version 2 for more details (a copy is included in the LICENSE file that
0N/A * accompanied this code).
0N/A *
0N/A * You should have received a copy of the GNU General Public License version
0N/A * 2 along with this work; if not, write to the Free Software Foundation,
0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A *
2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2362N/A * or visit www.oracle.com if you need additional information or have any
2362N/A * questions.
0N/A */
0N/A
0N/A
0N/Apackage com.sun.jmx.snmp;
0N/A
0N/A
0N/A
0N/A
0N/A/**
0N/A * Represents an SNMP IpAddress.
0N/A *
0N/A * <p><b>This API is a Sun Microsystems internal API and is subject
0N/A * to change without notice.</b></p>
0N/A */
0N/A
0N/Apublic class SnmpIpAddress extends SnmpOid {
0N/A private static final long serialVersionUID = 7204629998270874474L;
0N/A
0N/A // CONSTRUCTORS
0N/A //-------------
0N/A /**
0N/A * Constructs a new <CODE>SnmpIpAddress</CODE> from the specified bytes array.
0N/A * @param bytes The four bytes composing the address.
0N/A * @exception IllegalArgumentException The length of the array is not equal to four.
0N/A */
0N/A public SnmpIpAddress(byte[] bytes) throws IllegalArgumentException {
0N/A buildFromByteArray(bytes);
0N/A }
0N/A
0N/A /**
0N/A * Constructs a new <CODE>SnmpIpAddress</CODE> from the specified long value.
0N/A * @param addr The initialization value.
0N/A */
0N/A public SnmpIpAddress(long addr) {
0N/A int address = (int)addr ;
0N/A byte[] ipaddr = new byte[4];
0N/A
0N/A ipaddr[0] = (byte) ((address >>> 24) & 0xFF);
0N/A ipaddr[1] = (byte) ((address >>> 16) & 0xFF);
0N/A ipaddr[2] = (byte) ((address >>> 8) & 0xFF);
0N/A ipaddr[3] = (byte) (address & 0xFF);
0N/A
0N/A buildFromByteArray(ipaddr);
0N/A }
0N/A
0N/A /**
0N/A * Constructs a new <CODE>SnmpIpAddress</CODE> from a dot-formatted <CODE>String</CODE>.
0N/A * The dot-formatted <CODE>String</CODE> is formulated x.x.x.x .
0N/A * @param dotAddress The initialization value.
0N/A * @exception IllegalArgumentException The string does not correspond to an ip address.
0N/A */
0N/A public SnmpIpAddress(String dotAddress) throws IllegalArgumentException {
0N/A super(dotAddress) ;
0N/A if ((componentCount > 4) ||
0N/A (components[0] > 255) ||
0N/A (components[1] > 255) ||
0N/A (components[2] > 255) ||
0N/A (components[3] > 255)) {
0N/A throw new IllegalArgumentException(dotAddress) ;
0N/A }
0N/A }
0N/A
0N/A /**
0N/A * Constructs a new <CODE>SnmpIpAddress</CODE> from four long values.
0N/A * @param b1 Byte 1.
0N/A * @param b2 Byte 2.
0N/A * @param b3 Byte 3.
0N/A * @param b4 Byte 4.
0N/A * @exception IllegalArgumentException A value is outside of [0-255].
0N/A */
0N/A public SnmpIpAddress(long b1, long b2, long b3, long b4) {
0N/A super(b1, b2, b3, b4) ;
0N/A if ((components[0] > 255) ||
0N/A (components[1] > 255) ||
0N/A (components[2] > 255) ||
0N/A (components[3] > 255)) {
0N/A throw new IllegalArgumentException() ;
0N/A }
0N/A }
0N/A
0N/A // PUBLIC METHODS
0N/A //---------------
0N/A /**
0N/A * Converts the address value to its byte array form.
0N/A * @return The byte array representation of the value.
0N/A */
0N/A public byte[] byteValue() {
0N/A byte[] result = new byte[4] ;
0N/A result[0] = (byte)components[0] ;
0N/A result[1] = (byte)components[1] ;
0N/A result[2] = (byte)components[2] ;
0N/A result[3] = (byte)components[3] ;
0N/A
0N/A return result ;
0N/A }
0N/A
0N/A /**
0N/A * Converts the address to its <CODE>String</CODE> form.
0N/A * Same as <CODE>toString()</CODE>. Exists only to follow a naming scheme.
0N/A * @return The <CODE>String</CODE> representation of the value.
0N/A */
0N/A public String stringValue() {
0N/A return toString() ;
0N/A }
0N/A
0N/A /**
0N/A * Extracts the ip address from an index OID and returns its
0N/A * value converted as an <CODE>SnmpOid</CODE>.
0N/A * @param index The index array.
0N/A * @param start The position in the index array.
0N/A * @return The OID representing the ip address value.
0N/A * @exception SnmpStatusException There is no ip address value
0N/A * available at the start position.
0N/A */
0N/A public static SnmpOid toOid(long[] index, int start) throws SnmpStatusException {
0N/A if (start + 4 <= index.length) {
0N/A try {
0N/A return new SnmpOid(
0N/A index[start],
0N/A index[start+1],
0N/A index[start+2],
0N/A index[start+3]) ;
0N/A }
0N/A catch(IllegalArgumentException e) {
0N/A throw new SnmpStatusException(SnmpStatusException.noSuchName) ;
0N/A }
0N/A }
0N/A else {
0N/A throw new SnmpStatusException(SnmpStatusException.noSuchName) ;
0N/A }
0N/A }
0N/A
0N/A /**
0N/A * Scans an index OID, skips the address value and returns the position
0N/A * of the next value.
0N/A * @param index The index array.
0N/A * @param start The position in the index array.
0N/A * @return The position of the next value.
0N/A * @exception SnmpStatusException There is no address value
0N/A * available at the start position.
0N/A */
0N/A public static int nextOid(long[] index, int start) throws SnmpStatusException {
0N/A if (start + 4 <= index.length) {
0N/A return start + 4 ;
0N/A }
0N/A else {
0N/A throw new SnmpStatusException(SnmpStatusException.noSuchName) ;
0N/A }
0N/A }
0N/A
0N/A /**
0N/A * Appends an <CODE>SnmpOid</CODE> representing an <CODE>SnmpIpAddress</CODE> to another OID.
0N/A * @param source An OID representing an <CODE>SnmpIpAddress</CODE> value.
0N/A * @param dest Where source should be appended.
0N/A */
0N/A public static void appendToOid(SnmpOid source, SnmpOid dest) {
0N/A if (source.getLength() != 4) {
0N/A throw new IllegalArgumentException() ;
0N/A }
0N/A dest.append(source) ;
0N/A }
0N/A
0N/A /**
0N/A * Returns a textual description of the type object.
0N/A * @return ASN.1 textual description.
0N/A */
0N/A final public String getTypeName() {
0N/A return name ;
0N/A }
0N/A
0N/A // PRIVATE METHODS
0N/A //----------------
0N/A /**
0N/A * Build Ip address from byte array.
0N/A */
0N/A private void buildFromByteArray(byte[] bytes) {
0N/A if (bytes.length != 4) {
0N/A throw new IllegalArgumentException() ;
0N/A }
0N/A components = new long[4] ;
0N/A componentCount= 4;
0N/A components[0] = (bytes[0] >= 0) ? bytes[0] : bytes[0] + 256 ;
0N/A components[1] = (bytes[1] >= 0) ? bytes[1] : bytes[1] + 256 ;
0N/A components[2] = (bytes[2] >= 0) ? bytes[2] : bytes[2] + 256 ;
0N/A components[3] = (bytes[3] >= 0) ? bytes[3] : bytes[3] + 256 ;
0N/A }
0N/A
0N/A // VARIABLES
0N/A //----------
0N/A /**
0N/A * Name of the type.
0N/A */
0N/A final static String name = "IpAddress" ;
0N/A}