java.awt.image
클래스 SinglePixelPackedSampleModel

java.lang.Object 
  java.awt.image.SampleModel 
      java.awt.image.SinglePixelPackedSampleModel

public class SinglePixelPackedSampleModel
extends SampleModel 

이 클래스는 1개의 픽셀을 구성하는 N개의 샘플이 1개의 데이터 배열 요소에 포함되도록 팩 된 픽셀 데이터를 나타냅니다. 데이터 배열 요소의 각 데이터는 1개의 픽셀만의 샘플을 보관 유지합니다. 이 클래스는 TYPE_BYTE, TYPE_USHORT, TYPE_INT 각 데이터형을 지원합니다. 모든 데이터 배열 요소는 DataBuffer 최초의 뱅크에 상주합니다. 이미지 데이터를 직접 조작할 수 있도록, 액세스용 메서드가 제공되고 있습니다. 주사선 보폭은 지정된 샘플과 다음의 주사선의 같은 열의 대응하는 샘플과의 사이의 데이터 배열 요소의 수입니다. 비트 마스크는 픽셀의 밴드를 나타내는 샘플을 추출하는데 필요한 마스크입니다. 비트 오프셋(offset)는 픽셀의 밴드를 나타내는 샘플의 데이터 배열 요소에의 비트 단위의 오프셋(offset)입니다.

다음의 코드는 DataBuffer data로 부터, 픽셀 x, y 밴드 b를 나타내는 샘플의 비트를 추출하는 예입니다.

      int sample = data.getElem(y * scanlineStride + x);
      sample = (sample & bitMasks[b]) >>> bitOffsets[b];
 

필드 개요

클래스 java.awt.image. SampleModel 로부터 상속된 필드

dataType, height, numBands, width

생성자 개요

SinglePixelPackedSampleModel (int dataType, int w, int h, int[] bitMasks)
bitMasks.length 밴드를 사용해 SinglePixelPackedSampleModel를 구축합니다.

SinglePixelPackedSampleModel (int dataType, int w, int h, int scanlineStride, int[] bitMasks)
bitMasks.length 밴드, 그리고 scanlineStride 데이터 배열 요소와 일치하는 주사선 보넓이를 사용해 SinglePixelPackedSampleModel를 구축합니다.

메서드 개요

SampleModel	createCompatibleSampleModel (int w, int h) 지정된 폭과 높이를 사용해 새로운 SinglePixelPackedSampleModel를 작성합니다.
DataBuffer	createDataBuffer () 이 SinglePixelPackedSampleModel에 대응하는 DataBuffer를 생성합니다.
SampleModel	createSubsetSampleModel (int[] bands) 이 SinglePixelPackedSampleModel 밴드의 부분집합을 사용해 새로운 SinglePixelPackedSampleModel를 작성합니다.
boolean	equals (Object o) 이 객체와 다른 객체가 동일한지 어떤지를 나타냅니다.
int[]	getBitMasks () 모든 밴드의 비트 마스크를 리턴합니다.
int[]	getBitOffsets () 모든 밴드의 픽셀을 나타내는 데이터 배열 요소에 비트 오프셋(offset)를 리턴합니다.
Object	getDataElements (int x, int y, Object obj, DataBuffer data) transferType 형의 원시적 배열내의 1개의 픽셀의 데이터를 리턴합니다.
int	getNumDataElements () getDataElements 메서드 및 setDataElements 메서드를 사용해 1 픽셀 전송 하는데 필요한 데이터 요소의 수를 리턴합니다.
int	getOffset (int x, int y) 픽셀 (x, y)의 데이터 배열 요소내의 오프셋(offset)를 리턴합니다.
int[]	getPixel (int x, int y, int[] iArray, DataBuffer data) int 배열의 지정된 픽셀의 모든 샘플을 리턴합니다.
int[]	getPixels (int x, int y, int w, int h, int[] iArray, DataBuffer data) int 배열의 지정된 픽셀의 구형의 모든 샘플을 리턴합니다.
int	getSample (int x, int y, int b, DataBuffer data) (x, y)에 위치하는 픽셀의, 지정된 밴드내의 샘플을 int 로서 리턴합니다.
int[]	getSamples (int x, int y, int w, int h, int b, int[] iArray, DataBuffer data) int 배열의 지정된 픽셀의 구형의, 지정된 밴드의 샘플을 리턴합니다.
int[]	getSampleSize () 모든 밴드의 샘플 근처의 비트수를 리턴합니다.
int	getSampleSize (int band) 지정된 밴드의 샘플 근처의 비트수를 리턴합니다.
int	getScanlineStride () 이 SinglePixelPackedSampleModel 주사선 보넓이를 리턴합니다.
int	hashCode () 객체의 해시 코드값을 리턴합니다.
void	setDataElements (int x, int y, Object obj, DataBuffer data) TransferType 형의 원시적 배열로부터의, 지정한 DataBuffer 내의 1개의 픽셀의 데이터를 설정합니다.
void	setPixel (int x, int y, int[] iArray, DataBuffer data) 샘플의 int 배열을 입력으로서 DataBuffer 내의 픽셀을 설정합니다.
void	setPixels (int x, int y, int w, int h, int[] iArray, DataBuffer data) 배열 요소 마다 1개의 샘플이 포함되고 있는 int 배열로부터, 픽셀의 구형의 모든 샘플을 설정합니다.
void	setSample (int x, int y, int b, int s, DataBuffer data) int를 입력으로 해, DataBuffer 내의 것 (x, y)에 위치하는 픽셀의, 지정한 밴드내의 샘플을 설정합니다.
void	setSamples (int x, int y, int w, int h, int b, int[] iArray, DataBuffer data) 배열 요소 마다 1개의 샘플이 포함되고 있는 int 배열로부터, 지정된 픽셀의 구형의 지정된 밴드내의 샘플을 설정합니다.

클래스 java.awt.image. SampleModel 로부터 상속된 메서드

getDataElements, getDataType, getHeight, getNumBands, getPixel, getPixel, getPixels, getPixels, getSampleDouble, getSampleFloat, getSamples, getSamples, getTransferType, getWidth, setDataElements, setPixel, setPixel, setPixels, setPixels, setSample, setSample, setSamples, setSamples

클래스 java.lang. Object 로부터 상속된 메서드

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

생성자 상세

SinglePixelPackedSampleModel

public SinglePixelPackedSampleModel(int dataType,
                                    int w,
                                    int h,
                                    int[] bitMasks)

bitMasks.length 밴드를 사용해 SinglePixelPackedSampleModel를 구축합니다. 각 샘플은 데이터 배열 요소의 대응하는 비트 마스크의 위치에 포함됩니다. 각 비트 마스크는 연속하고 있을 필요가 있어, 복수의 마스크를 오버랩 시킬 수 없습니다.

파라미터:

dataType - 샘플의 포함을 위한 데이터형

w - 기술된 이미지 데이터의 영역의넓이 (픽셀수)

h - 기술된 이미지 데이터의 영역의 높이 (픽셀수)

bitMasks - 모든 밴드의 비트 마스크

예외:

IllegalArgumentException - dataType가 DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, 또는 DataBuffer.TYPE_INT 어떤 것도 아닌 경우

SinglePixelPackedSampleModel

public SinglePixelPackedSampleModel(int dataType,
                                    int w,
                                    int h,
                                    int scanlineStride,
                                    int[] bitMasks)

bitMasks.length 밴드, 그리고 scanlineStride 데이터 배열 요소와 일치하는 주사선 보넓이를 사용해 SinglePixelPackedSampleModel를 구축합니다. 각 샘플은 데이터 배열 요소의 대응하는 비트 마스크의 위치에 포함됩니다. 각 비트 마스크는 연속하고 있을 필요가 있어, 복수의 마스크를 오버랩 시킬 수 없습니다.

파라미터:

dataType - 샘플의 포함을 위한 데이터형

w - 기술되는 이미지 데이터의 영역의넓이 (픽셀수)

h - 기술되는 이미지 데이터의 영역의 높이 (픽셀수)

scanlineStride - 이미지 데이터의 주사선 보폭

bitMasks - 모든 밴드의 비트 마스크

예외:

IllegalArgumentException - w 또는 h가 제로 아래의 경우

IllegalArgumentException - bitMask 마스크가 연속하지 않은 경우

IllegalArgumentException - dataType가 DataBuffer.TYPE_BYTE, DataBuffer.TYPE_USHORT, 또는 DataBuffer.TYPE_INT 어떤 것도 아닌 경우

메서드의 상세

getNumDataElements

public int getNumDataElements()

getDataElements 메서드 및 setDataElements 메서드를 사용해 1 픽셀 전송 하는데 필요한 데이터 요소의 수를 리턴합니다. SinglePixelPackedSampleModel인 경우는 1 이 됩니다.

정의:

클래스 SampleModel 내의 getNumDataElements

createCompatibleSampleModel

public SampleModel  createCompatibleSampleModel(int w,
                                               int h)

지정된 폭과 높이를 사용해 새로운 SinglePixelPackedSampleModel를 작성합니다. 새로운 SinglePixelPackedSampleModel 스토리지 데이터형과 비트 마스크는 이 SinglePixelPackedSampleModel와 같게 됩니다.

정의:

클래스 SampleModel 내의 createCompatibleSampleModel

파라미터:

w - 결과적으로 리턴된 SampleModel 폭

h - 결과적으로 리턴된 SampleModel 높이

반환값:

지정된 폭과 높이를 가지는 SinglePixelPackedSampleModel 객체

예외:

IllegalArgumentException - w 또는 h가 제로 아래의 경우

createDataBuffer

public DataBuffer  createDataBuffer()

이 SinglePixelPackedSampleModel에 대응하는 DataBuffer를 생성합니다. DataBuffer 데이터형과 사이즈는 이 SinglePixelPackedSampleModel와 일치합니다. DataBuffer는 1개의 뱅크를 가집니다.

정의:

클래스 SampleModel 내의 createDataBuffer

반환값:

이 SampleModel에 대응하는 DataBuffer

getSampleSize

public int[] getSampleSize()

모든 밴드의 샘플 근처의 비트수를 리턴합니다.

정의:

클래스 SampleModel 내의 getSampleSize

getSampleSize

public int getSampleSize(int band)

지정된 밴드의 샘플 근처의 비트수를 리턴합니다.

정의:

클래스 SampleModel 내의 getSampleSize

getOffset

public int getOffset(int x,
                     int y)

픽셀 (x, y)의 데이터 배열 요소내의 오프셋(offset)를 리턴합니다. 픽셀 x, y가 포함되고 있는 데이터 요소는 다음과 같이 SinglePixelPackedSampleModel sppsm를 사용해 DataBuffer data로 부터 꺼낼 수가 있습니다.

        data.getElem(sppsm.getOffset(x, y));
 

파라미터:

x, y - 지정된 픽셀의 좌표

반환값:

지정된 픽셀의 오프셋(offset)

getBitOffsets

public int[] getBitOffsets()

모든 밴드의 픽셀을 나타내는 데이터 배열 요소에 비트 오프셋(offset)를 리턴합니다. @return 모든 밴드의 픽셀을 나타내는 비트 오프셋(offset)

getBitMasks

public int[] getBitMasks()

모든 밴드의 비트 마스크를 리턴합니다. @return 모든 밴드의 비트 마스크

getScanlineStride

public int getScanlineStride()

이 SinglePixelPackedSampleModel 주사선 보넓이를 리턴합니다. @return 이 SinglePixelPackedSampleModel 주사선 보폭

createSubsetSampleModel

public SampleModel  createSubsetSampleModel(int[] bands)

이 SinglePixelPackedSampleModel 밴드의 부분집합을 사용해 새로운 SinglePixelPackedSampleModel를 작성합니다. 새로운 SinglePixelPackedSampleModel 은 기존의 SinglePixelPackedSampleModel 로 사용 가능한 임의의 DataBuffer와 함께 사용할 수 있습니다. SinglePixelPackedSampleModel와 DataBuffer 새로운 편성은 원의 편성의 밴드의 부분집합을 사용해 이미지를 나타냅니다.

정의:

클래스 SampleModel 내의 createSubsetSampleModel

파라미터:

bands - 이 SampleModel 밴드의 부분집합

반환값:

이 SampleModel 밴드의 부분집합을 가지는 SampleModel

예외:

RasterFormatException - bands 인수의 길이가 샘플 모델의 밴드수보다 큰 경우

getDataElements

public Object  getDataElements(int x,
                              int y,
                              Object  obj,
                              DataBuffer  data)

transferType 형의 원시적 배열내의 1개의 픽셀의 데이터를 리턴합니다. SinglePixelPackedSampleModel인 경우, 배열은 1개의 요소를 가져, 형태는 스토리지 데이터형과 같게 됩니다. 일반적으로 Object가 자동적으로 작성되어 올바른 기본 데이터형이 되도록, obj에는 null이 건네받습니다.

다음의 코드는 SinglePixelPackedSampleModel sppsm1에 의해 스토리지 레이아웃이 기술되고 있는 DataBuffer db1로 부터, SinglePixelPackedSampleModel sppsm2에 의해 스토리지 레이아웃이 기술되고 있는 DataBuffer db2에 1 픽셀의 데이터를 전송 하는 예입니다. 보통, 이 전송은 getPixel와 setPixel를 사용하는 것보다도 효율적입니다.

             SinglePixelPackedSampleModel sppsm1, sppsm2;
             DataBufferInt db1, db2;
                     sppsm2.setDataElements(x, y, sppsm1.getDataElements(x, y, null,
                              db1), db2);
 

SampleModel 밴드수가 같아, 대응하는 밴드의 샘플 근처의 비트수가 같아, TransferType가 같은 경우, 2개의 DataBuffer/SampleModel 간의 전송에는 getDataElements/setDataElements를 사용하는 것이 적절합니다.

obj가 null이 아닌 경우는 TransferType 형의 원시적 배열이 됩니다. 그렇지 않은 경우는 ClassCastException가 발생 됩니다. 좌표가 경계내에 없는 경우, 또는 obj가 null이 아니고, 픽셀 데이터를 포함하기 위해서 충분한 사이즈가 아닌 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

정의:

클래스 SampleModel 내의 getDataElements

파라미터:

x - 픽셀 위치의 X 좌표

y - 픽셀 위치의 Y 좌표

obj - null이 아닌 경우는 픽셀 데이터가 리턴된 원시적 배열

data - 이미지 데이터를 포함하는 DataBuffer

반환값:

지정된 픽셀의 데이터

관련 항목:

setDataElements(int, int, Object, DataBuffer)

getPixel

public int[] getPixel(int x,
                      int y,
                      int[] iArray,
                      DataBuffer  data)

int 배열의 지정된 픽셀의 모든 샘플을 리턴합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

오버라이드(override):

클래스 SampleModel 내의 getPixel

파라미터:

x - 픽셀 위치의 X 좌표

y - 픽셀 위치의 Y 좌표

iArray - null이 아닌 경우, 이 배열내의 샘플을 돌려주는

data - 이미지 데이터를 포함하는 DataBuffer

반환값:

지정된 픽셀의 모든 샘플

관련 항목:

setPixel(int, int, int[], DataBuffer)

getPixels

public int[] getPixels(int x,
                       int y,
                       int w,
                       int h,
                       int[] iArray,
                       DataBuffer  data)

int 배열의 지정된 픽셀의 구형의 모든 샘플을 리턴합니다. 배열 요소 마다 1개의 샘플이 리턴됩니다 . 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

오버라이드(override):

클래스 SampleModel 내의 getPixels

파라미터:

x - 좌상의 픽셀 위치의 X 좌표

y - 좌상의 픽셀 위치의 Y 좌표

w - 픽셀 구형의 폭

h - 픽셀 구형의 높이

iArray - null이 아닌 경우, 이 배열내의 샘플을 돌려주는

data - 이미지 데이터를 포함하는 DataBuffer

반환값:

지정된 픽셀 영역의 샘플

관련 항목:

setPixels(int, int, int, int, int[], DataBuffer)

getSample

public int getSample(int x,
                     int y,
                     int b,
                     DataBuffer  data)

(x, y)에 위치하는 픽셀의, 지정된 밴드내의 샘플을 int 로서 리턴합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생되는 일이 있습니다.

정의:

클래스 SampleModel 내의 getSample

파라미터:

x - 픽셀 위치의 X 좌표

y - 픽셀 위치의 Y 좌표

b - 리턴된 밴드

data - 이미지 데이터를 포함하는 DataBuffer

반환값:

지정된 픽셀에 대한 지정된 밴드의 샘플

관련 항목:

setSample(int, int, int, int, DataBuffer)

getSamples

public int[] getSamples(int x,
                        int y,
                        int w,
                        int h,
                        int b,
                        int[] iArray,
                        DataBuffer  data)

int 배열의 지정된 픽셀의 구형의, 지정된 밴드의 샘플을 리턴합니다. 배열 요소 마다 1개의 샘플이 리턴됩니다 . 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

오버라이드(override):

클래스 SampleModel 내의 getSamples

파라미터:

x - 좌상의 픽셀 위치의 X 좌표

y - 좌상의 픽셀 위치의 Y 좌표

w - 픽셀 구형의 폭

h - 픽셀 구형의 높이

b - 리턴된 밴드

iArray - null이 아닌 경우, 이 배열내의 샘플을 돌려주는

data - 이미지 데이터를 포함하는 DataBuffer

반환값:

지정된 픽셀 영역의 지정된 밴드의 샘플

관련 항목:

setSamples(int, int, int, int, int, int[], DataBuffer)

setDataElements

public void setDataElements(int x,
                            int y,
                            Object  obj,
                            DataBuffer  data)

TransferType 형의 원시적 배열로부터의, 지정한 DataBuffer 내의 1개의 픽셀의 데이터를 설정합니다. SinglePixelPackedSampleModel인 경우, 배열의 최초의 요소만이 유효한 데이터를 보관 유지합니다. 배열의 형태는 SinglePixelPackedSampleModel 스토리지 데이터형과 같은 필요가 있습니다.

다음의 코드는 SinglePixelPackedSampleModel sppsm1에 의해 스토리지 레이아웃이 기술되고 있는 DataBuffer db1로 부터, SinglePixelPackedSampleModel sppsm2에 의해 스토리지 레이아웃이 기술되고 있는 DataBuffer db2에 1 픽셀의 데이터를 전송 하는 예입니다. 보통, 이 전송은 getPixel와 setPixel를 사용하는 것보다도 효율적입니다.

             SinglePixelPackedSampleModel sppsm1, sppsm2;
             DataBufferInt db1, db2;
             sppsm2.setDataElements(x, y, sppsm1.getDataElements(x, y, null,
                              db1), db2);
 

SampleModel 밴드수가 같아, 대응하는 밴드의 샘플 근처의 비트수가 같아, TransferType가 같은 경우, 2개의 DataBuffer/SampleModel 간의 전송에는 getDataElements/setDataElements를 사용하는 것이 적절합니다.

obj는 TransferType 형의 원시적 배열이 아니면 안됩니다. 그렇지 않은 경우는 ClassCastException가 발생 됩니다. 좌표가 경계내에 없는 경우, 또는 obj가 픽셀 데이터를 포함하기 위해서 충분한 사이즈가 아닌 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

정의:

클래스 SampleModel 내의 setDataElements

파라미터:

x - 픽셀 위치의 X 좌표

y - 픽셀 위치의 Y 좌표

obj - 픽셀 데이터를 포함하는 원시적 배열

data - 이미지 데이터를 포함하는 DataBuffer

관련 항목:

getDataElements(int, int, Object, DataBuffer)

setPixel

public void setPixel(int x,
                     int y,
                     int[] iArray,
                     DataBuffer  data)

샘플의 int 배열을 입력으로서 DataBuffer 내의 픽셀을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

오버라이드(override):

클래스 SampleModel 내의 setPixel

파라미터:

x - 픽셀 위치의 X 좌표

y - 픽셀 위치의 Y 좌표

iArray - int 배열 형식의 입력 샘플

data - 이미지 데이터를 포함하는 DataBuffer

관련 항목:

getPixel(int, int, int[], DataBuffer)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      int[] iArray,
                      DataBuffer  data)

배열 요소 마다 1개의 샘플이 포함되고 있는 int 배열로부터, 픽셀의 구형의 모든 샘플을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

오버라이드(override):

클래스 SampleModel 내의 setPixels

파라미터:

x - 좌상의 픽셀 위치의 X 좌표

y - 좌상의 픽셀 위치의 Y 좌표

w - 픽셀 구형의 폭

h - 픽셀 구형의 높이

iArray - int 배열 형식의 입력 샘플

data - 이미지 데이터를 포함하는 DataBuffer

관련 항목:

getPixels(int, int, int, int, int[], DataBuffer)

setSample

public void setSample(int x,
                      int y,
                      int b,
                      int s,
                      DataBuffer  data)

int를 입력으로 해, DataBuffer 내의 것 (x, y)에 위치하는 픽셀의, 지정한 밴드내의 샘플을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

정의:

클래스 SampleModel 내의 setSample

파라미터:

x - 픽셀 위치의 X 좌표

y - 픽셀 위치의 Y 좌표

b - 설정되는 밴드

s - int 입력 샘플

data - 이미지 데이터를 포함하는 DataBuffer

관련 항목:

getSample(int, int, int, DataBuffer)

setSamples

public void setSamples(int x,
                       int y,
                       int w,
                       int h,
                       int b,
                       int[] iArray,
                       DataBuffer  data)

배열 요소 마다 1개의 샘플이 포함되고 있는 int 배열로부터, 지정된 픽셀의 구형의 지정된 밴드내의 샘플을 설정합니다. 좌표가 경계내에 없는 경우는 ArrayIndexOutOfBoundsException가 발생 됩니다.

오버라이드(override):

클래스 SampleModel 내의 setSamples

파라미터:

x - 좌상의 픽셀 위치의 X 좌표

y - 좌상의 픽셀 위치의 Y 좌표

w - 픽셀 구형의 폭

h - 픽셀 구형의 높이

b - 설정되는 밴드

iArray - int 배열 형식의 입력 샘플

data - 이미지 데이터를 포함하는 DataBuffer

관련 항목:

getSamples(int, int, int, int, int, int[], DataBuffer)

equals

public boolean equals(Object  o)

클래스 Object 기술:

이 객체와 다른 객체가 동일한지 어떤지를 나타냅니다.

equals 메서드는 null 이외의 객체 참조에서의 동치 관계를 구현합니다.

• 반사성 (reflexive): null 이외의 참조치 x에 대해, x.equals(x)는 true를 돌려준다
• 대칭성 (symmetric): null 이외의 참조치 x와 y에 대해, x.equals(y)는 y.equals(x)가 true를 돌려주는 경우만 true를 돌려준다
• 추이성 (transitive): null 이외의 참조치 x, y, z에 대해, x.equals(y)가 true를 돌려주고, 한편 y.equals(z)가 true를 돌려주는 경우에 x.equals(z)는 true를 돌려준다
• 정합성 (consistent): null 이외의 참조치 x 및 y에 대해, x.equals(y)를 복수 호출하면 항상 true를 돌려주는지, 항상 false를 돌려준다. 이것은 객체에 대한 equals에 한 비교로 사용된 정보가 변경되어 있지 않은 것이 조건이다
• null 이외의 참조치 x에 대해, x.equals(null)는 false를 돌려준다

Object 클래스의 equals 메서드는 가장 비교하기 쉬운 객체의 동치 관계를 구현합니다. 즉, null 이외의 참조치 x와 y에 대해, 이 메서드는 x와 y가 같은 객체를 참조하는 (x == y가 true) 경우에만 true를 리턴합니다.

보통, 이 메서드를 오버라이드(override) 하는 경우는 hashCode 메서드를 항상 오버라이드(override) 해, 「등가인 객체는 등가인 해시 코드를 보관 유지할 필요가 있다」라고 하는 hashCode 메서드의 범용 규약에 따를 필요가 있는 것에 유의해 주세요.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

o - 비교 대상의 참조 객체

반환값:

obj 인수로 지정된 객체와 이 객체가 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

클래스 Object 기술:

객체의 해시 코드값을 리턴합니다. 이 메서드는 java.util.Hashtable에 의해 제공되는 것 같은 해시 테이블로 사용하기 위해서 준비되어 있습니다.

hashCode 메서드의 일반적인 규칙을 다음에 나타냅니다.

• Java 어플리케이션의 실행중에 같은 객체상에서 여러 차례 호출되는 경우는 반드시, 이 객체에 대한 equals에 한 비교로 사용된 정보가 변경되어 있지 않으면, hashCode 메서드는 같은 정수를 일관해 돌려주지 않으면 안 된다. 어플리케이션을 한 번 종료하고 나서 한번 더 같은 어플리케이션을 실행했을 경우, 이 메서드로부터 리턴된 정수는 전회의 실행시에 리턴된 정수와 같다라고는 한정되지 않는다
• equals(Object) 메서드로 2개의 객체가 등가로 여겨졌을 경우, 어느 쪽의 객체로 hashCode 메서드를 호출해도 결과는 같은 정수값이 되어야 하다
• Object.equals(java.lang.Object) 메서드로 2개의 객체가 등가가 아니다고 여겨졌을 경우는 이러한 객체에 대해서 hashCode 메서드를 호출했을 때에 결과가 다른 정수값이 되지 않아도 상관없다. 그러나, 동일하지 않은 객체에 대해서는 다른 정수값이 생성되도록 하면, 해시 테이블의 퍼포먼스를 올릴 수가 있다

할 수 있는 한, Object 클래스에서 정의되는 hashCode 메서드는 다른 객체에 대해서는 다른 정수값을 리턴합니다. 보통, 이것은 객체의 내부 주소를 정수값 로 변환하는 형태로 구현됩니다만, 그러한 구현 테크닉은 Java^TM 프로그램 언어에서는 불필요합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

Object.equals(java.lang.Object), Hashtable