public class MACAddressSection extends AddressDivisionGrouping implements AddressSection, java.lang.Iterable<MACAddressSection>
| Modifier and Type | Class and Description |
|---|---|
static class |
MACAddressSection.MACStringOptions
Represents a clear way to create a specific type of string.
|
AddressDivisionGrouping.StringOptions| Modifier and Type | Field and Description |
|---|---|
boolean |
extended |
int |
startIndex |
| Constructor and Description |
|---|
MACAddressSection(byte[] bytes) |
MACAddressSection(byte[] bytes,
int startIndex,
boolean extended) |
MACAddressSection(byte[] bytes,
int startIndex,
boolean extended,
java.lang.Integer prefixLength) |
MACAddressSection(byte[] bytes,
java.lang.Integer prefixLength) |
MACAddressSection(long value) |
MACAddressSection(long value,
int startIndex,
boolean extended) |
MACAddressSection(long value,
int startIndex,
boolean extended,
java.lang.Integer prefixLength) |
MACAddressSection(long value,
java.lang.Integer prefixLength) |
MACAddressSection(MACAddressSegment segment)
Constructs a single segment section, the segment being the leading segment.
|
MACAddressSection(MACAddressSegment[] segments)
Use this constructor for any address section that includes the leading segment of a MAC address
|
MACAddressSection(MACAddressSegment[] segments,
int startIndex,
boolean extended) |
MACAddressSection(MACAddressSegment[] segments,
int startIndex,
boolean extended,
java.lang.Integer prefixLength) |
MACAddressSection(MACAddressSegment[] segments,
java.lang.Integer prefixLength) |
MACAddressSection(MACAddressSegment segment,
int startIndex,
boolean extended)
Constructs a single segment section with the segment at the given index in the address.
|
| Modifier and Type | Method and Description |
|---|---|
MACAddressSection |
adjustPrefixBySegment(boolean nextSegment)
Increases or decreases prefix length to the next segment boundary.
|
MACAddressSection |
adjustPrefixLength(int adjustment)
Increases or decreases prefix length by the given increment.
|
MACAddressSection |
append(MACAddressSection other) |
MACAddressSection |
applyPrefixLength(int prefixLength)
Applies the given prefix length to create a new segment series representing all segment series starting with the same prefix.
|
boolean |
contains(AddressSection other)
Determines if one section contains another.
|
boolean |
contains(MACAddressSection other) |
boolean |
equals(java.lang.Object o) |
int |
getBitCount() |
int |
getBitsPerSegment() |
int |
getByteCount()
returns the number of bytes in each of the address components represented by this instance
|
int |
getBytesPerSegment() |
AddressDivisionGrouping |
getDottedGrouping() |
java.lang.Iterable<MACAddressSection> |
getIterable()
Useful for using an instance in a "for-each loop".
|
MACAddressSection |
getLower()
If this instance represents multiple address components, returns the one with the lowest numeric value.
|
MACAddressSection |
getODISection() |
int |
getODISegmentCount() |
MACAddressSection |
getOUISection() |
int |
getOUISegmentCount() |
java.lang.Integer |
getPrefixLength()
The bit-length of the portion of the address that is not specific to an individual address but common amongst a group of addresses.
|
MACAddressSection |
getSection(int index)
Gets the subsection from the series starting from the given index
|
MACAddressSection |
getSection(int index,
int endIndex)
Gets the subsection from the series starting from the given index and ending just before the give endIndex
|
MACAddressSegment |
getSegment(int index) |
int |
getSegmentCount() |
MACAddressSegment[] |
getSegments() |
void |
getSegments(AddressSegment[] segs) |
void |
getSegments(java.util.Collection<? super MACAddressSegment> segs) |
void |
getSegments(int start,
int end,
AddressSegment[] segs,
int destIndex)
get the segments from start to end and insert into the segs array at the the given index
|
void |
getSegments(int start,
int end,
java.util.Collection<? super MACAddressSegment> segs) |
MACAddressSection |
getUpper()
If this instance represents multiple address components, returns the one with the highest numeric value.
|
boolean |
isEntireAddress(boolean extended) |
boolean |
isEUI64(boolean asMAC)
Equivalent to isEUI64(asMAC, false)
|
boolean |
isEUI64(boolean asMAC,
boolean partial)
Whether this section is consistent with an EUI64 section,
which means it came from an extended 8 byte address,
and the corresponding segments in the middle match 0xff and 0xff/fe for MAC/not-MAC
|
boolean |
isExtended() |
boolean |
isMultipleByPrefix()
whether there is a prefix and it is less than the bit-count
|
boolean |
isPrefixed()
Indicates if the address represents all devices with the same OUI segments.
|
java.util.Iterator<MACAddressSection> |
iterator()
An address component can represent a single segment, address, or section, or it can represent multiple,
typically a subnet or range of segment, address, or section values.
|
MACAddressSection |
prepend(MACAddressSection other) |
MACAddressSection |
removePrefixLength()
Removes the prefix.
|
MACAddressSection |
replace(MACAddressSection other,
int index) |
MACAddressSection |
reverseBits(boolean perByte)
Returns a new segment series with the bits reversed.
|
MACAddressSection |
reverseBytes()
Returns a new segment series with the bytes reversed.
|
MACAddressSection |
reverseBytesPerSegment()
Returns a new segment series with the bytes reversed within each segment.
|
MACAddressSection |
reverseSegments()
Returns a new segment series with the segments reversed.
|
java.util.Iterator<MACAddressSegment[]> |
segmentsIterator() |
MACAddressSection |
setPrefixLength(int networkPrefixLength)
Sets the prefix length.
|
java.lang.String |
toCanonicalString()
This produces a canonical string using the canonical standardized IEEE 802 MAC address representation of xx-xx-xx-xx-xx-xx
For range segments, '..' is used: 11-22-33..44-55-66
|
java.lang.String |
toColonDelimitedString() |
java.lang.String |
toCompressedString()
This produces a shorter string for the address that uses the canonical representation but not using leading zeroes.
|
java.lang.String |
toDashedString() |
java.lang.String |
toDottedString()
This produces the dotted hexadecimal format aaaa.bbbb.cccc
|
MACAddressSection |
toEUI64(boolean asMAC)
If this section is part of a shorter 48 bit MAC or EUI-48 address see
isExtended(),
then the required sections are inserted (FF-FF for MAC, FF-FE for EUI-48) to extend it to EUI-64. |
IPv6AddressSection |
toEUI64IPv6() |
java.lang.String |
toHexString(boolean with0xPrefix)
Writes this address as a single hexadecimal value with always the exact same number of characters, with or without a preceding 0x prefix.
|
java.lang.String |
toNormalizedString()
The normalized string returned by this method is the most common representation of MAC addresses: xx:xx:xx:xx:xx:xx
|
java.lang.String |
toNormalizedString(AddressDivisionGrouping.StringOptions stringOptions) |
static java.lang.String |
toNormalizedString(AddressDivisionGrouping.StringOptions opts,
AddressDivisionGrouping section) |
MACAddressSection |
toOUIPrefixed() |
java.lang.String |
toSpaceDelimitedString()
This produces a string delimited by spaces: aa bb cc dd ee ff
|
java.lang.String |
toString() |
compareTo, getBytes, getBytes, getCount, getDivision, getDivisionCount, getEquivalentPrefix, getMinPrefix, getUpperBytes, getUpperBytes, hashCode, isFullRange, isMore, isMultiple, isRangeEquivalent, isRangeEquivalentToPrefix, isZerogetDivision, getEquivalentPrefix, getMinPrefix, isMore, isRangeEquivalentToPrefixgetDivisionCountgetBytes, getBytes, getCount, getUpperBytes, getUpperBytes, isFullRange, isMultiple, isZeropublic MACAddressSection(MACAddressSegment segment)
segment - public MACAddressSection(MACAddressSegment segment, int startIndex, boolean extended)
segment - public MACAddressSection(MACAddressSegment[] segments)
public MACAddressSection(MACAddressSegment[] segments, int startIndex, boolean extended)
public MACAddressSection(MACAddressSegment[] segments, java.lang.Integer prefixLength)
public MACAddressSection(MACAddressSegment[] segments, int startIndex, boolean extended, java.lang.Integer prefixLength)
public MACAddressSection(byte[] bytes,
int startIndex,
boolean extended,
java.lang.Integer prefixLength)
public MACAddressSection(byte[] bytes,
int startIndex,
boolean extended)
public MACAddressSection(byte[] bytes,
java.lang.Integer prefixLength)
public MACAddressSection(byte[] bytes)
public MACAddressSection(long value,
int startIndex,
boolean extended,
java.lang.Integer prefixLength)
public MACAddressSection(long value,
int startIndex,
boolean extended)
public MACAddressSection(long value,
java.lang.Integer prefixLength)
public MACAddressSection(long value)
public boolean equals(java.lang.Object o)
equals in class AddressDivisionGroupingpublic MACAddressSegment[] getSegments()
getSegments in interface AddressSegmentSeriespublic void getSegments(AddressSegment[] segs)
getSegments in interface AddressSegmentSeriespublic void getSegments(int start,
int end,
AddressSegment[] segs,
int destIndex)
AddressSegmentSeriesgetSegments in interface AddressSegmentSeriespublic boolean isExtended()
public int getSegmentCount()
getSegmentCount in interface AddressSegmentSeriespublic boolean isEntireAddress(boolean extended)
public MACAddressSegment getSegment(int index)
getSegment in interface AddressSegmentSeriespublic void getSegments(java.util.Collection<? super MACAddressSegment> segs)
public void getSegments(int start,
int end,
java.util.Collection<? super MACAddressSegment> segs)
public int getByteCount()
AddressComponentgetByteCount in interface AddressComponentpublic int getBitCount()
getBitCount in interface AddressItemgetBitCount in class AddressDivisionGroupingpublic int getBitsPerSegment()
getBitsPerSegment in interface AddressSegmentSeriespublic int getBytesPerSegment()
getBytesPerSegment in interface AddressSegmentSeriespublic boolean isPrefixed()
isPrefixed in interface AddressDivisionSeriesisPrefixed in class AddressDivisionGroupingpublic int getOUISegmentCount()
public int getODISegmentCount()
public java.lang.Integer getPrefixLength()
AddressDivisionSeriesgetPrefixLength in interface AddressDivisionSeriesgetPrefixLength in class AddressDivisionGroupingpublic boolean isMultipleByPrefix()
AddressDivisionSeriesisMultipleByPrefix in interface AddressDivisionSeriesisMultipleByPrefix in class AddressDivisionGroupingpublic MACAddressSection getSection(int index)
AddressSegmentSeriesgetSection in interface AddressSectiongetSection in interface AddressSegmentSeriespublic MACAddressSection getSection(int index, int endIndex)
AddressSegmentSeriesgetSection in interface AddressSectiongetSection in interface AddressSegmentSeriespublic MACAddressSection getOUISection()
public MACAddressSection getODISection()
public MACAddressSection toOUIPrefixed()
public IPv6AddressSection toEUI64IPv6()
public boolean isEUI64(boolean asMAC)
public boolean isEUI64(boolean asMAC,
boolean partial)
partial - whether missing segments are considered a match (this only has an effect if this section came from an extended 8 byte address),
or in other words, we don't consider 6 byte addresses to be "missing" the bytes that would make it 8 byte.asMAC - whether to search for the ffff or fffe patternpublic MACAddressSection toEUI64(boolean asMAC)
isExtended(),
then the required sections are inserted (FF-FF for MAC, FF-FE for EUI-48) to extend it to EUI-64.
However, if the section does not encompass the parts of the address where
the new sections should be placed, then the section is unchanged.
If the section is already part of an EUI-64 address, then it is checked
to see if it has the segments that identify it as extended to EUI-64 (FF-FF for MAC, FF-FE for EUI-48),
and if not, AddressTypeException is thrown.asMAC - public MACAddressSection replace(MACAddressSection other, int index)
public MACAddressSection prepend(MACAddressSection other)
public MACAddressSection append(MACAddressSection other)
public boolean contains(MACAddressSection other)
other - public MACAddressSection getLower()
AddressComponentgetLower in interface AddressComponentgetLower in interface AddressSectiongetLower in interface AddressSegmentSeriespublic MACAddressSection getUpper()
AddressComponentgetUpper in interface AddressComponentgetUpper in interface AddressSectiongetUpper in interface AddressSegmentSeriespublic MACAddressSection reverseBits(boolean perByte)
AddressSegmentSeriesreverseBits in interface AddressComponentreverseBits in interface AddressSectionreverseBits in interface AddressSegmentSeriesperByte - if true, only the bits in each byte are reversed, if false, then all bits in the component are reversedpublic MACAddressSection reverseBytes()
AddressSegmentSeriesreverseBytes in interface AddressComponentreverseBytes in interface AddressSectionreverseBytes in interface AddressSegmentSeriespublic MACAddressSection reverseBytesPerSegment()
AddressSegmentSeriesreverseBytesPerSegment in interface AddressSectionreverseBytesPerSegment in interface AddressSegmentSeriespublic MACAddressSection reverseSegments()
AddressSegmentSeriesreverseSegments in interface AddressSectionreverseSegments in interface AddressSegmentSeriespublic MACAddressSection removePrefixLength()
AddressSegmentSeriesremovePrefixLength in interface AddressSectionremovePrefixLength in interface AddressSegmentSeriespublic MACAddressSection adjustPrefixBySegment(boolean nextSegment)
AddressSegmentSeriesadjustPrefixBySegment in interface AddressSectionadjustPrefixBySegment in interface AddressSegmentSeriespublic MACAddressSection adjustPrefixLength(int adjustment)
AddressSegmentSeriesadjustPrefixLength in interface AddressSectionadjustPrefixLength in interface AddressSegmentSeriespublic MACAddressSection applyPrefixLength(int prefixLength)
AddressSegmentSeriesapplyPrefixLength in interface AddressSectionapplyPrefixLength in interface AddressSegmentSeriespublic MACAddressSection setPrefixLength(int networkPrefixLength)
AddressSegmentSeriessetPrefixLength in interface AddressSectionsetPrefixLength in interface AddressSegmentSeriespublic java.lang.Iterable<MACAddressSection> getIterable()
AddressComponentAddressComponent.iterator() directly.getIterable in interface AddressComponentgetIterable in interface AddressSectiongetIterable in interface AddressSegmentSeriespublic java.util.Iterator<MACAddressSection> iterator()
AddressComponentAddressItem.isMultiple() to determine if this instance represents multiple.
This method iterates through the individual elements.iterator in interface AddressComponentiterator in interface AddressSectioniterator in interface AddressSegmentSeriesiterator in interface java.lang.Iterable<MACAddressSection>public java.util.Iterator<MACAddressSegment[]> segmentsIterator()
segmentsIterator in interface AddressSegmentSeriespublic java.lang.String toHexString(boolean with0xPrefix)
toHexString in interface AddressComponentpublic java.lang.String toNormalizedString(AddressDivisionGrouping.StringOptions stringOptions)
public static java.lang.String toNormalizedString(AddressDivisionGrouping.StringOptions opts, AddressDivisionGrouping section)
public java.lang.String toNormalizedString()
toNormalizedString in interface AddressComponentpublic java.lang.String toCanonicalString()
toCanonicalString in interface AddressSegmentSeriespublic java.lang.String toCompressedString()
toCompressedString in interface AddressSegmentSeriespublic java.lang.String toDottedString()
public java.lang.String toSpaceDelimitedString()
public java.lang.String toDashedString()
public java.lang.String toColonDelimitedString()
public java.lang.String toString()
toString in class AddressDivisionGroupingpublic AddressDivisionGrouping getDottedGrouping()
public boolean contains(AddressSection other)
AddressSectioncontains in interface AddressSection