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 - 기술된 이미지 데이터의 area의 폭 (픽셀수)

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

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 - 기술되는 이미지 데이터의 area의 폭 (픽셀수)

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

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

반환값:

데이터 요소수

관련 항목:

SampleModel.getDataElements(int, int, Object, DataBuffer) , SampleModel.getDataElements(int, int, int, int, Object, DataBuffer) , SampleModel.setDataElements(int, int, Object, DataBuffer) , SampleModel.setDataElements(int, int, int, int, Object, DataBuffer) , SampleModel.getTransferType()

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

파라미터:

band - 지정된 밴드

반환값:

지정된 밴드의 샘플의 사이즈

getOffset

public int getOffset(int x,
                     int y)

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

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

반환값:

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

getBitOffsets

public int[] getBitOffsets()

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

반환값:

모든 밴드의 픽셀을 나타내는 비트 오프셋(offset)

getBitMasks

public int[] getBitMasks()

모든 밴드의 비트 마스크를 돌려줍니다.

반환값:

모든 밴드의 비트 마스크

getScanlineStride

public int getScanlineStride()

이 SinglePixelPackedSampleModel 의 주사선 보폭을 돌려줍니다.

반환값:

이 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

반환값:

지정된 픽셀 area의 샘플

관련 항목:

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

반환값:

지정된 픽셀 area의 지정된 밴드의 샘플

관련 항목:

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 메소드는 동치 관계를 구현합니다.

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

Object 클래스의 equals 메소드는 가장 비교하기 쉬운 오브젝트의 동치 관계를 구현합니다. 즉, 모든 참조치 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