Spec-Zone .ru спецификации, руководства, описания, API

ГЛАВА 7

Пакеты

Программы Java организуются как наборы пакетов. У каждого пакета есть свой собственный набор имен для типов, который помогает предотвратить конфликты имен. Тип доступен (§6.6) вне пакета, который объявляет это, только если тип объявляется public.

Структура именования для пакетов является иерархической (§7.1). Элементы пакета являются классом и интерфейсными типами (§7.6), которые объявляются в единицах компиляции пакета, и подпакетов, которые могут содержать единицы компиляции и собственные подпакеты.

Пакет может быть сохранен в файловой системе (§7.2.1) или в базе данных (§7.2.2). У пакетов, которые сохранены в файловой системе, есть определенные ограничения на организацию их единиц компиляции, чтобы позволить простой реализации находить классы легко. В любом случае набор пакетов, доступных программе Java, определяется хост-системой, но должен всегда включать, по крайней мере, три стандартных пакета java.lang, java.util, и java.io как определено в Главах 20, 21, и 22. В большинстве сред узла, стандартных пакетах java.applet, java.awt, и java.net, которые не описываются в этой спецификации, также доступны программам Java.

Пакет состоит из многих единиц компиляции (§7.3). Единица компиляции автоматически имеет доступ ко всем типам, объявленным в его пакете, и также автоматически импортирует каждый из типов, объявленных в предопределенном пакете java.lang.

У единицы компиляции есть три части, каждая из которых является дополнительной:

• A package объявление (§7.4), давая полностью определенное имя (§6.7) пакета, которому принадлежит единица компиляции
• import объявления (§7.5), которые позволяют типам от других пакетов быть отнесенными в использование их простых имен
• Описания типа (§7.6) класса и интерфейсных типов

7.1 Элементы пакета

• Подпакеты пакета
• Типы, объявленные в единицах компиляции (§7.3) пакета

• Пакет java имеет подпакеты awt, applet, io, lang, net, и util, но никакие единицы компиляции.
• Пакет java.awt назвали подпакет image, так же как много единиц компиляции, содержащих объявления класса и интерфейсных типов.

Подпакеты пакета java именованный lang, util, и io (чьи полностью определенные имена пакета поэтому java.lang, java.util, и java.io) стандартный компонент каждой реализации Java и определяется в Главах 20, 21, и 22. Много реализаций Java будут включать весь набор java пакеты, определенные в ряде книг Прикладной программный интерфейс Java.

Пакет, возможно, не содержит описание типа и подпакет того же самого имени, или ошибка времени компиляции заканчивается. Вот некоторые примеры:

• Поскольку пакет java.awt имеет подпакет image, это не может (и не делать), содержат объявление класса или интерфейсного названного типа image.
• Если есть названный пакет mouse и тип Button в том пакете (который тогда мог бы упоминаться как mouse.Button), тогда не может быть никакого пакета с полностью определенным именем mouse.Button или mouse.Button.Click.
• Если COM.Sun.java.jag полностью определенное имя типа, тогда не может быть никакого пакета, полностью определенное имя которого также COM.Sun.java.jag или COM.Sun.java.jag.scrabble.

7.2 Поддержка узла Пакетов

Пакеты могут быть сохранены в локальной файловой системе в простых реализациях Java. Другие реализации могут использовать распределенную файловую систему или некоторую форму базы данных, чтобы сохранить Java исходный и/или двоичный код.

7.2.1 Хранение Пакетов в Файловой системе

COM
gls
jag
java
wnj

Продолжая пример, каталог java вероятно, содержал бы, по крайней мере, следующие подкаталоги:

applet	
awt
io
lang
net
util

Все еще продолжая пример, если мы должны были смотреть в каталоге util, мы могли бы видеть следующие файлы:

BitSet.java										Observable.java
BitSet.class										Observable.class
Date.java										Observer.java
Date.class										Observer.class
Dictionary.java										Properties.java
Dictionary.class										Properties.class
EmptyStackException.java										Random.java
EmptyStackException.class										Random.class
Enumeration.java										Stack.java
Enumeration.class										Stack.class
Hashtable.java										StringTokenizer.java
Hashtable.class										StringTokenizer.class
NoSuchElementException.java										Vector.java
NoSuchElementException.class										Vector.class

Под этой простой организацией пакетов реализация Java преобразовала бы имя пакета в путь, связывая компоненты имени пакета, помещая разделитель имени файла (индикатор каталога) между смежными компонентами. Например, если эта простая организация использовалась на системе UNIX, где разделитель имени файла /, имя пакета:

jag.scrabble.board

jag/scrabble/board

COM.Sun.sunsoft.DOE

COM/Sun/sunsoft/DOE

Имя компонента имени пакета или имя класса могли бы содержать символ, который не может правильно появиться в обычном имени каталога файловой системы узла, таком как символ Unicode на системе, которая позволяет только символы ASCII в именах файлов. Как соглашение, при использовании символа можно оставить, скажем, @ символ, сопровождаемый четырьмя шестнадцатеричными цифрами, дающими числовое значение символа, как в \uescape xxxx (§3.3), так, чтобы имя пакета:

children.activities.crafts.papierM\u00e2ch\u00e9

children.activities.crafts.papierMâché

children/activities/crafts/papierM@00e2ch@00e9

7.2.2 Хранение Пакетов в Базе данных

Java позволяет такой базе данных ослаблять ограничения (§7.6) на единицах компиляции в основанных на файле реализациях. Например, система, которая использует базу данных, чтобы сохранить пакеты, не должна осуществить максимум одного public класс или интерфейс на единицу компиляции. Системы, которые используют базу данных, должны, однако, предоставить возможность преобразовывать программу Java в форму, которая повинуется ограничениям в целях экспорта в основанные на файле реализации.

7.3 Единицы компиляции

CompilationUnit:

	PackageDeclarationopt ImportDeclarationsopt TypeDeclarationsopt

ImportDeclarations:

	ImportDeclaration

	ImportDeclarations ImportDeclaration

TypeDeclarations:

	TypeDeclaration

	TypeDeclarations TypeDeclaration

Единица компиляции состоит из трех частей, каждая из которых является дополнительной:

• A package объявление (§7.4), давая полностью определенное имя (§6.7) пакета, которому принадлежит единица компиляции
• import объявления (§7.5), которые позволяют типам от других пакетов быть отнесенными в использование их простых имен
• Описания типа (§7.6) класса и интерфейсных типов

7.4 Объявления пакета

7.4.1 Названный Пакетами

PackageDeclaration:

	package PackageName ;

Если тип по имени T объявляется в единице компиляции пакета, полностью определенное имя которого является P, то полностью определенное имя типа является P.T; таким образом в примере:

package wnj.points;
class Point { int x, y; }

7.4.2 Неназванные Пакеты

class FirstCall {
	public static void main(String[] args) {
		System.out.println("Mr. Watson, come here. "
									+ "I want you.");
	}
}

Система Java должна поддерживать по крайней мере один неназванный пакет; это может поддерживать больше чем один неназванный пакет, но не обязано делать так. То, какие единицы компиляции находятся в каждом неназванном пакете, определяется хост-системой.

В системах Java, которые используют иерархическую файловую систему для того, чтобы сохранить пакеты, одна типичная стратегия состоит в том, чтобы связать неназванный пакет с каждым каталогом; только один неназванный пакет доступен за один раз, а именно, тот, который связывается с "текущим рабочим каталогом." Точное значение "текущего рабочего каталога" зависит от хост-системы.

Неназванные пакеты обеспечиваются Java преимущественно для удобства, разрабатывая маленькие или временные приложения или только начиная разработку.

Предостережение должно быть взято при использовании неназванных пакетов. Для единицы компиляции в именованном пакете возможно импортировать тип из неназванного пакета, но скомпилированная версия этой единицы компиляции будет, вероятно, тогда работать только, когда тот определенный неназванный пакет будет "текущим". Поэтому строго рекомендуется, чтобы единицы компиляции именованных пакетов никогда не импортировали типы из неназванных пакетов. Также рекомендуется, чтобы любой тип, объявленный в неназванном пакете не, был объявлен public, сохранить их от того, чтобы случайно быть импортированным именованным пакетом.

Рекомендуется, чтобы система Java обеспечила гарантии против непреднамеренных последствий в ситуациях, куда единицы компиляции именованных пакетов импортируют типы из неназванных пакетов. Одна стратегия состоит в том, чтобы обеспечить способ связать с каждым именованным пакетом самое большее один неназванный пакет, и затем обнаружить и предупредить о ситуациях, в которых именованный пакет используется больше чем одним неназванным пакетом. Это определенно не требуется действительно, этому строго обескураживают - для реализации, чтобы поддерживать использование именованного пакета больше чем одним неназванным пакетом, поддерживая многократные скомпилированные версии именованного пакета.

7.4.3 Контекст и Сокрытие Имени Пакета

Имена пакета никогда не скрывают другие имена.

7.4.4 Доступ к Элементам Пакета

Строго рекомендуется, чтобы защиты файловой системы или базы данных, используемой, чтобы сохранить программы Java, были установлены сделать все единицы компиляции пакета доступными всякий раз, когда любая из единиц компиляции доступна.

7.5 Объявления импорта

ImportDeclaration:

	SingleTypeImportDeclaration

	TypeImportOnDemandDeclaration

import объявление делает типы доступными их простыми именами только в пределах единицы компиляции, которая фактически содержит import объявление. Контекст имени (ен), которое это представляет определенно, не включает package оператор, другой import операторы в текущей единице компиляции, или других единицах компиляции в том же самом пакете. Пожалуйста, см. §7.5.4 для иллюстративного примера.

7.5.1 Объявление единственного импорта типа

SingleTypeImportDeclaration:

	import TypeName ;

Пример:

import java.util.Vector;

Если два объявления единственного импорта типа в той же самой единице компиляции пытаются импортировать типы с тем же самым простым именем, то ошибка времени компиляции происходит, если два типа не являются тем же самым типом, когда двойное объявление игнорируется. Если другой тип с тем же самым именем иначе объявляется в текущей единице компиляции кроме объявлением "импорт типа по требованию" (§7.5.2), то ошибка времени компиляции происходит.

Так пример программы:

import java.util.Vector;

class Vector { Object[] vec; }

import java.util.Vector;

import myVector.Vector;

package myVector;

public class Vector { Object[] vec; }

Отметьте, что оператор импорта не может импортировать подпакет, только тип. Например, это не работает, чтобы попытаться импортировать java.util и затем используйте имя util.Random обратиться к типу java.util.Random:

import java.util;										// incorrect: compile-time error

class Test { util.Random generator; }

7.5.2 Объявление "Импорт типа по требованию"

TypeImportOnDemandDeclaration:

	import PackageName . * ;

Пример:

import java.util.*;

7.5.3 Автоматический Импорт

import java.lang.*;

Полная спецификация java.lang дается в Главе 20. Следующий public типы определяются в java.lang:

AbstractMethodError										LinkageError
ArithmeticException										Long
ArrayStoreException										Math
Boolean										NegativeArraySizeException
Character										NoClassDefFoundError
Class										NoSuchFieldError
ClassCastException										NoSuchMethodError
ClassCircularityError										NullPointerException
ClassFormatError										Number
ClassLoader										NumberFormatException
ClassNotFoundException										Object
CloneNotSupportedException										OutOfMemoryError
Cloneable										Process
Compiler										Runnable
Double										Runtime
Error										RuntimeException
Exception										SecurityException
ExceptionInInitializerError										SecurityManager
Float										StackOverflowError
IllegalAccessError										String
IllegalAccessException										StringBuffer
IllegalArgumentException										System
IllegalMonitorStateException										Thread
IllegalThreadStateException										ThreadDeath
IncompatibleClassChangeError										ThreadGroup
IndexOutOfBoundsException										Throwable
InstantiationError										UnknownError
InstantiationException										UnsatisfiedLinkError
Integer										VerifyError
InternalError										VirtualMachineError
InterruptedException

7.5.4 Странный Пример

package Vector;

public class Mosquito { int capacity; }

package strange.example;


import java.util.Vector;


import Vector.Mosquito;

class Test {
	public static void main(String[] args) {
		System.out.println(new Vector().getClass());
		System.out.println(new Mosquito().getClass());
	}
}

class java.util.Vector
class Vector.Mosquito

7.6 Описания типа

TypeDeclaration:

	ClassDeclaration

	InterfaceDeclaration

	;

class date { int month, day, year; };

По умолчанию типы, объявленные в пакете, доступны только в пределах единиц компиляции того пакета, но тип, как могут объявлять, public предоставить доступ к типу от кода в других пакетах (§6.6, §8.1.2, §9.1.2).

Реализация Java должна отследить типы в пределах пакетов их полностью определенными именами (§6.7). Многократные способы назвать тип должны быть расширены до полностью определенных имен, чтобы удостовериться, что такие имена понимаются как обращающийся к тому же самому типу. Например, если единица компиляции содержит объявление единственного импорта типа (§7.5.1):

import java.util.Vector;

Когда пакеты Java сохранены в файловой системе (§7.2.1), хост-система может хотеть осуществлять ограничение, что это - ошибка времени компиляции, если тип не находится в файле под именем, составленным из имени типа плюс расширение (такой как .java или .jav) если любое из следующего является истиной:

• Тип упоминается кодом в других единицах компиляции пакета, в котором объявляется тип.
• Тип объявляется public (и поэтому потенциально доступно от кода в других пакетах).

Когда пакеты Java сохранены в базе данных (§7.2.2), хост-система не должна осуществить такие ограничения.

Практически, много программистов Java хотят помещать каждый класс, или интерфейс вводят его собственную единицу компиляции, является ли это public или упоминается кодом в других единицах компиляции.

7.7 Уникальные Имена Пакета

Если уникальные имена пакета не используются, то конфликты имен пакета могут возникнуть далекие от точки создания любого из конфликтных пакетов. Это может создать ситуацию, которая является трудной или невозможной для пользователя или программиста решить. Класс ClassLoader (§20.14) стандартной среды виртуальной машины Java может использоваться, чтобы изолировать пакеты с тем же самым именем друг от друга в тех случаях, где пакеты ограничат взаимодействия, но не в пути, который прозрачен к наивной программе Java.

Вы формируете уникальное имя пакета, сначала имея (или принадлежа организации, которая имеет), имя Интернет-домена, такой как Sun.COM. Вы тогда инвертируете это имя, компонент компонентом, чтобы получить, в этом примере, COM.Sun, и используйте это, как префикс для Вашего пакета называет, используя соглашение разработанный в пределах Вашей организации, чтобы далее администрировать имена пакета.

Такое соглашение могло бы определить, что определенные компоненты имени каталога были подразделением, отделом, проектом, машиной, или именами для входа в систему. Некоторые возможные примеры:

COM.Sun.sunsoft.DOE
COM.Sun.java.jag.scrabble
COM.Apple.quicktime.v2
EDU.cmu.cs.bovik.cheese
GOV.whitehouse.socks.mousefinder

Имя пакета не предназначается, чтобы подразумевать что-либо о том, где пакет сохранен в пределах Интернета; например, пакет называют EDU.cmu.cs.bovik.cheese не обязательно доступно от Интернет-адреса cmu.EDU или от cs.cmu.EDU или от bovik.cs.cmu.EDU. Соглашение Java для того, чтобы генерировать уникальные имена пакета является просто способом перевезти по железной дороге соглашение о присвоении имен пакета сверху существующего, широко известного реестра уникального имени вместо того, чтобы иметь необходимость создать отдельный реестр для имен пакета Java.

Если Вы должны получить новое имя Интернет-домена, можно получить анкету от ftp://ftp.internic.net и представьте полные формы по Электронной почте к domreg@internic.net. Чтобы узнать, каковы в настоящий момент зарегистрированные доменные имена, Вы можете telnet к rs.internic.net и используйте whois средство.

Содержание | Предыдущий | Следующий | Индекс

Спецификация языка Java (HTML, сгенерированный Блинчиком "сюзет" Pelouch 24 февраля 1998)
Авторское право © Sun Microsystems, Inc 1996 года. Все права защищены
Пожалуйста, отправьте любые комментарии или исправления к doug.kramer@sun.com