JavaTM Platform
Standard Ed. 6

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 형의 프리미티브(primitive) 배열내의 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 형의 프리미티브(primitive) 배열로부터의, 지정한 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 - dataTypeDataBuffer.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 가 0 이하인 경우
IllegalArgumentException - bitMask 의 마스크가 연속하지 않은 경우
IllegalArgumentException - dataTypeDataBuffer.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 가 0 이하인 경우

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));
 

파라미터:
x - 지정된 픽셀의 X 좌표
y - 지정된 픽셀의 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 형의 프리미티브(primitive) 배열내의 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 형의 프리미티브(primitive) 배열이 됩니다. 그렇지 않은 경우는, ClassCastException 가 throw 됩니다. 좌표가 경계내에 없는 경우, 또는 obj 가 null 가 아니고, 픽셀 데이터를 포함하기 위해서 충분한 사이즈가 아닌 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다.

정의:
클래스 SampleModel 내의 getDataElements
파라미터:
x - 픽셀 위치의 X 좌표
y - 픽셀 위치의 Y 좌표
obj - null 가 아닌 경우는, 픽셀 데이터가 반환된다 프리미티브(primitive) 배열
data - 이미지 데이터를 포함하는 DataBuffer
반환값:
지정된 픽셀의 데이터
관련 항목:
setDataElements(int, int, Object, DataBuffer)

getPixel

public int[] getPixel(int x,
                      int y,
                      int[] iArray,
                      DataBuffer  data)
int 배열의 지정된 픽셀의 모든 샘플을 돌려줍니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다.

오버라이드(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 가 throw 됩니다.

오버라이드(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 가 throw 됩니다.

정의:
클래스 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 가 throw 됩니다.

오버라이드(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 형의 프리미티브(primitive) 배열로부터의, 지정한 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 형의 프리미티브(primitive) 배열이 아니면 안됩니다. 그렇지 않은 경우는, ClassCastException 가 throw 됩니다. 좌표가 경계내에 없는 경우, 또는 obj 가 픽셀 데이터를 포함하기 위해서 충분한 사이즈가 아닌 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다.

정의:
클래스 SampleModel 내의 setDataElements
파라미터:
x - 픽셀 위치의 X 좌표
y - 픽셀 위치의 Y 좌표
obj - 픽셀 데이터를 포함하는 프리미티브(primitive) 배열
data - 이미지 데이터를 포함하는 DataBuffer
관련 항목:
getDataElements(int, int, Object, DataBuffer)

setPixel

public void setPixel(int x,
                     int y,
                     int[] iArray,
                     DataBuffer  data)
샘플의 int 배열을 입력으로서 사용해 DataBuffer 내의 픽셀을 설정합니다. 좌표가 경계내에 없는 경우는, ArrayIndexOutOfBoundsException 가 throw 됩니다.

오버라이드(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 가 throw 됩니다.

오버라이드(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 가 throw 됩니다.

정의:
클래스 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 가 throw 됩니다.

오버라이드(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 이외의 객체 참조에서의 동치 관계를 구현합니다.

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

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

오버라이드(override):
클래스 Object 내의 equals
파라미터:
o - 비교 대상의 참조 객체
반환값:
obj 인수로 지정된 객체와 이 객체가 동일한 경우는 true, 그렇지 않은 경우는 false
관련 항목:
Object.hashCode() , Hashtable

hashCode

public int hashCode()
클래스 Object 의 기술:
객체의 해시 코드값를 돌려줍니다. 이 메소드는,java.util.Hashtable 에 의해 제공되는 것 같은 해시 테이블로 사용하기 위해서 준비되어 있습니다.  

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

할 수 있는 한,Object 클래스에서 정의되는 hashCode 메소드는, 다른 객체에 대해서는 다른 정수치를 돌려줍니다. 일반적으로, 이것은 객체의 내부 주소를 정수치로 변환하는 형태로 구현됩니다만, 그러한 구현 테크닉은 JavaTM 프로그램 언어에서는 불필요합니다.

오버라이드(override):
클래스 Object 내의 hashCode
반환값:
이 객체의 해시 코드값
관련 항목:
Object.equals(java.lang.Object) , Hashtable

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.