javax.swing
클래스 SizeSequence

java.lang.Object 
  javax.swing.SizeSequence

public class SizeSequence
extends Object 

SizeSequence객체는 사이즈 및 대응하는 위치의, 정렬 된 리스트를 효과적으로 유지합니다. SizeSequence 상황으로서 적절한 예로서는 사이즈가 동일하지 않은 복수의 행을 표시하는 컴퍼넌트의 경우가 있습니다. 이 경우 단일의 SizeSequence 객체를 사용해, 모든 행의 높이와 Y 위치를 추적할 수 있습니다.

이제 1개의 예로서 열사이즈가 동일하지 않은 JTable 등의 복수열컴퍼넌트가 있습니다. JTable은 단일의 SizeSequence 객체를 사용해 모든 열의 폭과 X 위치를 포함할 수 있습니다. 계속되어 JTable은 SizeSequence 객체를 사용해 특정의 위치에 대응하는 열을 찾아낼 수가 있습니다. 1개 또는 복수의 열사이즈가 변경이 되었을 때에는 언제라도, JTable은 SizeSequence 객체를 갱신할 수 있습니다.

다음의 그림은 복수열컴퍼넌트의 사이즈와 위치 데이터의 관계를 나타내고 있습니다.

이 그림으로 최초의 인덱스 (0)는 최초의 열에 대응해, 2번째의 인덱스 (1)는 2번째의 열에 대응한다,와 같이 되어 있습니다. 최초의 열의 위치는 0 으로 시작되어, 이 열은 size₀ 픽셀을 차지합니다. size₀ 은 getSize(0)가 돌려주는 값입니다. 따라서 최초의 열은 size₀ - 1 으로 끝납니다. 계속되어 2번째의 열이 size₀ 으로부터 시작되어, size₁ (getSize(1)) 픽셀을 차지합니다.

SizeSequence객체는 단지 축으로 따른 간격을 나타냅니다. 상기의 예에서는 간격은 픽셀 단위의 높이 또는 넓이를 나타내고 있습니다. 그러나, 하루 가운데 시간 등, 다른 측정 단위도 똑같이 유효합니다.

구현상의 주의:

보통, 엔트리의 사이즈와 위치를 포함하려면, 사이즈의 포함인가 또는 위치의 포함의 어느 쪽인지를 선택합니다. 렌더링중에 필요한 공통 조작이 2개 있습니다. 그것들은, getIndex(position)와 setSize(index, size) 입니다. 내부 형식에 어느 쪽을 선택해도, 엔트리수가 커지면 2 조작의 어느 쪽인지는 효율이 나빠집니다. 사이즈를 포함했을 경우, 특정의 위치를 둘러싸는 엔트리의 인덱스의 검색은 엔트리수에 비례해 시간이 걸립니다. 반대로 위치를 포함했을 경우, 특정의 인덱스에 있는 엔트리의 사이즈의 설정은 영향을 받는 엔트리의 위치를 갱신할 필요가 있어, 역시 엔트리수에 비례해 계산에 시간이 걸립니다.

상기의 방법과 같이, 이 클래스는 내부에 N개의 정수의 배열을 보관 유지합니다만, 사이즈 베이스의 방법과 위치 베이스의 방법의 중간의, 하이브리드(hybrid)인 인코딩을 사용합니다. 이것에 의해 정보를 포함하는데 필요한 공간은 같습니다만, 대부분의 조작을 O(N) 시간은 아니고 Log(N) 시간에 실행할 수 있는 데이터 구조가 됩니다. N는 리스트에 있는 엔트리수입니다.

엔트리수의 O(N)인 채 남는 조작은, insertEntries 메서드와 removeEntries 메서드의 2개 입니다. 양메서드 모두, 내부 배열을 정수 사이즈세트로 변환해, 그것을 새로운 배열에 복사해, 그 후 하이브리드(hybrid) 표현을 적절히 수정하는 것에 의해 구현합니다.

생성자 개요

SizeSequence ()
엔트리를 포함하고 있지 않는 새로운 SizeSequence 객체를 생성합니다.

SizeSequence (int numEntries)
지정된 수의 엔트리를 포함하는 새로운 SizeSequence 객체를 생성합니다.

SizeSequence (int[] sizes)
지정된 사이즈를 포함하는 새로운 SizeSequence 객체를 생성합니다.

SizeSequence (int numEntries, int value)
지정된 수의 엔트리를 포함하는 새로운 SizeSequence 객체를 생성합니다.

메서드 개요

int	getIndex (int position) 지정된 위치에 대응하는 엔트리의 인덱스를 리턴합니다.
int	getPosition (int index) 지정된 배열의 개시 위치를 리턴합니다.
int	getSize (int index) 지정된 엔트리의 인덱스를 리턴합니다.
int[]	getSizes () 전엔트리의 사이즈를 리턴합니다.
void	insertEntries (int start, int length, int value) 연속하는 엔트리의 그룹을 이 SizeSequence에 추가합니다.
void	removeEntries (int start, int length) 연속하는 엔트리의 그룹을 이 SizeSequence로 부터 삭제합니다.
void	setSize (int index, int size) 지정된 엔트리의 사이즈를 설정합니다.
void	setSizes (int[] sizes) sizes인수를 사용해, 이 SizeSequence 객체를 리셋 합니다.

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

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

생성자 상세

SizeSequence

public SizeSequence()

엔트리를 포함하고 있지 않는 새로운 SizeSequence 객체를 생성합니다. 엔트리를 등록하려면, insertEntries 또는 setSizes를 사용합니다.

관련 항목:

insertEntries(int, int, int), setSizes(int[])

SizeSequence

public SizeSequence(int numEntries)

지정된 수의 엔트리를 포함하는 새로운 SizeSequence 객체를 생성합니다. 엔트리는 모두, 사이즈 0에 초기화되고 있습니다.

파라미터:

numEntries - 추적하는 사이즈의 수

예외:

NegativeArraySizeException - numEntries값이 0 보다 작은 경우

SizeSequence

public SizeSequence(int numEntries,
                    int value)

지정된 수의 엔트리를 포함하는 새로운 SizeSequence 객체를 생성합니다. 엔트리는 모두, 사이즈 value에 초기화되고 있습니다.

파라미터:

numEntries - 추적하는 사이즈의 수

value - 각 사이즈의 초기값

SizeSequence

public SizeSequence(int[] sizes)

지정된 사이즈를 포함하는 새로운 SizeSequence 객체를 생성합니다.

파라미터:

sizes - SizeSequence에 포함되는 사이즈의 배열

메서드의 상세

setSizes

public void setSizes(int[] sizes)

sizes인수를 사용해, 이 SizeSequence 객체를 리셋 합니다. 이 메서드는 이 객체가 sizes 배열과 동일한 엔트리를 포함하도록 초기화합니다. 각 엔트리의 사이즈는 sizes 대응하는 항목의 값에 초기화됩니다.

파라미터:

sizes - 이 SizeSequence에 포함되는 사이즈의 배열

getSizes

public int[] getSizes()

전엔트리의 사이즈를 리턴합니다.

반환값:

이 객체의 사이즈를 포함하는 새로운 배열

getPosition

public int getPosition(int index)

지정된 배열의 개시 위치를 리턴합니다. 예를 들어, getPosition(0)는 0을 돌려주고, getPosition(1)는 getSize(0)를, getPosition(2)는 getSize(0) + getSize(1)를 리턴합니다.

index가 length 보다 큰 경우, 리턴된 값은 무의미합니다.

파라미터:

index - 위값이 요구되고 있는 엔트리의 인덱스

반환값:

지정된 엔트리의 개시 위치

getIndex

public int getIndex(int position)

지정된 위치에 대응하는 엔트리의 인덱스를 리턴합니다. 예를 들어 getIndex(0)는 0 입니다만, 이것은 최초의 엔트리는 언제나 위치 0 으로부터 시작되기 때문에입니다.

파라미터:

position - 엔트리의 위치

반환값:

지정된 위치를 차지하는 엔트리의 인덱스

getSize

public int getSize(int index)

지정된 엔트리의 인덱스를 리턴합니다. index가 일정한 범위내 (0 <= index < getSizes(). length)에 없는 경우, 동작은 미확정입니다.

파라미터:

index - 엔트리에 대응하는 인덱스

반환값:

엔트리의 사이즈

setSize

public void setSize(int index,
                    int size)

지정된 엔트리의 사이즈를 설정합니다. index값이 일정한 범위내 (0 <= index < getSizes(). length)에 없는 경우, 동작은 미확정입니다.

파라미터:

index - 엔트리에 대응하는 인덱스

size - 엔트리의 사이즈

insertEntries

public void insertEntries(int start,
                          int length,
                          int value)

연속하는 엔트리의 그룹을 이 SizeSequence에 추가합니다. start와 length값은, (0 <= start < getSizes(). length) AND (length >= 0) 조건을 채울 필요가 있습니다. 이 조건을 채우지 않는 경우, 동작이 미확정인 모아 두어 예외가 발생되는 경우가 있습니다.

파라미터:

start - 그룹의 최초의 엔트리에 할당하는 인덱스

length - 그룹의 엔트리수

value - 새로운 각 엔트리에 할당하는 사이즈

예외:

ArrayIndexOutOfBoundsException - 파라미터가 일정한 범위 (0 <= start < (getSizes(). length)) AND (length >= 0) 내에 없는 경우

removeEntries

public void removeEntries(int start,
                          int length)

연속하는 엔트리의 그룹을 이 SizeSequence로 부터 삭제합니다. start와 length값은, (0 <= start < getSizes(). length) AND (length >= 0) 조건을 채울 필요가 있습니다. 이 조건을 채우지 않는 경우, 동작이 미확정인 모아 두어 예외가 발생되는 경우가 있습니다.

파라미터:

start - 삭제되는 최초의 엔트리의 인덱스

length - 삭제되는 엔트리의 수