спецификации, руководства, описания, API

Информация о Совместимости CORBA - J2SE 5.0

Изменения API CORBA Между J2SE 1.4.x и J2SE 5.0.x
Официальные Спецификации для CORBA поддерживают в J2SE 5.0.x
Другая информация о Совместимости

Изменения API CORBA Между J2SE 1.3 и J2SE 5.0

Этот документ содержит информацию относительно всех изменений API, связанных с функциональностью CORBA между JDK 1.3 и 5.0. Изменения были произведены, чтобы сделать API для технологии CORBA поставленными в JDK 5.0 совместимый к CORBA 2.3 отображения как определено следующими документами OMG:

CORBA 2.3.1 (formal/99-10-07)
IDL на язык Java, отображающийся (ptc/00-01-08)
Java на язык IDL, отображающийся (ptc/00-01-06)
Взаимодействующая Служба Именования (/ptc/00-08-07)
Переносимые Перехватчики (ptc/2001-03-04)

API изменяется на классы `org.omg.COSNaming`

Чтобы выполнить IDL к отображению Java, определенному спецификацией Версии 2.3 CORBA, следующие классы org.omg.COSNaming были регенерированы от компилятора idlj, поставленного с JDK. Это изменение (CCC 4284015) состоит из следующих изменений API. Воздействие совместимости: Ни один.

Чтобы соответствовать CORBA V (2.3) Весь Раздел Помощников 1.5.2 Спецификаций ptc/00-01-08.pdf, все Помощники являются теперь абстрактными общедоступными классами. Ниже список всех классов Помощника под org.omg.CosNaming, которые были изменены на абстрактные общедоступные классы.

BindingHelper.java
BindingIteratorHelper.java
BindingListHelper.java
BindingTypeHelper.java
IStringHelper.java
NameComponentHelper.java
NameHelper.java
NamingContextHelper.java
AlreadyBoundHelper.java
CannotProceedHelper.java
InvalidNameHelper.java
NotEmptyHelper.java
NotFoundHelper.java
NotFoundReasonHelper.java

Чтобы соответствовать Разделу 1.7 Спецификации OMG ptc/00-01-08.pdf, Отображаясь для Перечисления, отображение для следующих Перечислимых конструкторов изменяется на защищенный.

КЛАСС	ПРЕЖДЕ	ТЕПЕРЬ
`BindingType.java`	частный BindingType (интервал)	защищенный BindingType (интервал)
`NotFoundReason.java`	частный Нотфундрисон (интервал)	защищенный Нотфундрисон (интервал)

Чтобы соответствовать CORBA 2.3 спецификации (ptc/00-01-08.pdf), Удаление конструкторов в Тупиковых классах, следующие конструкторы были удалены.

КЛАСС	ПРЕЖДЕ	ТЕПЕРЬ
`_BindingIteratorStub.java`	общественность _BindingIteratorStub (org.omg. CORBA.portable. Делегат d)	Конструктор удаляется.
`_NamingContextStub.java`	общественность _NamingContextStub (org.omg. CORBA.portable. Делегат d)	Конструктор удаляется.

Чтобы соответствовать CORBA 2.3 спецификации (ptc/00-01-08.pdf), следующие исключения были изменены.

КЛАСС	ПРЕЖДЕ	ТЕПЕРЬ
`AlreadyBound.java`	общедоступный заключительный class AlreadyBound расширяет org.omg. CORBA.UserException реализует org.omg. CORBA.portable. IDLEntity	общедоступный заключительный class AlreadyBound расширяет org.omg. CORBA.UserException
`AlreadyBound.java`	Только конструктор по умолчанию	Добавьте новую общественность конструктора AlreadyBound (Строковая причина)
`CannotProceed.java`	общедоступный заключительный class CannotProceed расширяет org.omg. CORBA.UserException реализует org.omg. CORBA.portable. IDLEntity	общедоступный заключительный class CannotProceed расширяет org.omg. CORBA.UserException
`CannotProceed.java`	Только конструктор по умолчанию	Добавьте новую общественность конструктора CannotProceed (Строковая причина)
`InvalidName.java`	общедоступный заключительный class InvalidName расширяет org.omg. CORBA.UserException реализует org.omg. CORBA.portable. IDLEntity	общедоступный заключительный class InvalidName расширяет org.omg. CORBA.UserException
`InvalidName.java`	Только конструктор по умолчанию	Добавьте новую общественность конструктора InvalidName (Строковая причина)
`NotEmpty.java`	общедоступный заключительный class NotEmpty расширяет org.omg. CORBA.UserException реализует org.omg. CORBA.portable. IDLEntity	общедоступный заключительный class NotEmpty расширяет org.omg. CORBA.UserException
`NotEmpty.java`	Только конструктор по умолчанию	Добавьте новую общественность конструктора NotEmpty (Строковая причина)
`NotFound.java`	общедоступный заключительный class NotFound расширяет org.omg. CORBA.UserException реализует org.omg. CORBA.portable. IDLEntity	общедоступный заключительный class NotFound расширяет org.omg. CORBA.UserException
`NotFound.java`	Только конструктор по умолчанию	Добавьте новую общественность конструктора NotFound (Строка, org.omg.CosNaming.NamingContextPackage.NotFoundReason, org.omg. CosNaming. NameComponent [])

Чтобы соответствовать CORBA 2.3 спецификации, следующие классы были добавлены.
- NamingContextPOA.java
- BindingIteratorPOA.java
Чтобы соответствовать CORBA 2.3 спецификации, следующие классы осуждаются.
- _NamingContextImplBase.java
- _BindingIteratorImplBase.java

API изменяется на `org.omg.CORBA`

Чтобы соответствовать спецификации 99-07-57 OMG, IDL к отображению Java, следующие методы были изменены.
- Подпись метода org.omg.CORBA.Any.insert_fixed(java.math.BigDecimal, org.omg.CORBA.TypeCode) изменяется, чтобы выдать исключение org.omg.CORBA.Bad_INV_ORDER. Системное исключение не должно быть объявлено в коде пользователя. (CCC 4340915)
- Метод TypeCode.equivalent определяется как краткий обзор. ПРЕЖДЕ: выдавал исключение NO_IMPLEMENT. Воздействие совместимости: Минимальное воздействие для лиц, имеющих патент, не для конечного пользователя. Лица, имеющие патент должны обеспечить фиктивную реализацию этого метода. (CCC 4340932)
- Метод TypeCode.get_compact_typecode определяется как краткий обзор. ПРЕЖДЕ: выдавал исключение NO_IMPLEMENT. Воздействие совместимости: Минимальное воздействие для лиц, имеющих патент, не для конечного пользователя. Лица, имеющие патент должны обеспечить фиктивную реализацию этого метода. (CCC 4340932)
- Отображение для метода get_interface_def(org.omg.CORBA.Object) в org.omg.CORBA.portable.Delegate.java определяется как краткий обзор. Воздействие совместимости: Да, неабстрактный метод преобразовывается в краткий обзор. (CCC 4366071)
- Отображение для метода write_Principal() в org.omg.CORBA.portable.OutputStream.java больше не абстрактно. Воздействие совместимости: Нет, абстрактный метод преобразовывается в некраткий обзор. (CCC 4366072)
- Отображение для метода read_Principal() в org.omg.CORBA.portable.InputStream.java больше не абстрактно. Воздействие совместимости: Ни один, изменяя метод, который объявляется кратким обзором, чтобы больше не быть абстрактным, не повреждает совместимость с существующими ранее двоичными файлами. (CCC 4366074)
Чтобы приспособить CORBA 2.3 спецификациям, интерфейс org.omg.DomainManagerOperations больше не расширяет org.omg.CORBA.Object. Воздействие совместимости: Ни один, никакая программа CORBA не будет использовать интерфейс DomainManagerOperations непосредственно. Интерфейс DomainManagerOperations может только использоваться программами через интерфейс DomainManager, который уже расширяет org.omg.CORBA.Object. (CCC 4340907)
Следующие классы объявляются как краткий обзор и больше не имеют частного конструктора. (CCC 4372196)
- org.omg.CORBA.ServiceDetailHelper
- org.omg.CORBA.ServiceInformationHelper
Чтобы соответствовать IDL к спецификации Java в разделе 1.15.2, конструктор по умолчанию javadoc комментарии в следующих файлах org.omg.CORBA был изменен от COMPLETED_MAYBE до COMPLETED_NO. Воздействие совместимости: Ни один. (CCC 4363355)
- INTERNAL.java
- INVALID_TRANSACTION.java
- INV_OBJREF.java
Следующие классы Помощника в org.omg.CORBA были изменены от public final до public abstract, и конструктор по умолчанию для классов Помощника был удален. Это изменение было произведено, чтобы выполнить спецификацию ядра ШАРА как определено CORBA 2.3.1 и с Языком IDL/Java, отображающимся как определено в ptc/00-01-08. Воздействие совместимости: Минимальный, так как классы Помощника были сделаны 'абстрактными' как определено спецификацией отображения Языка IDL/Java OMG, приложения, которые ранее инстанцировали Помощника, которого приведет к сбою экземпляр class. Но Помощник, у class есть только статические методы в нем, и нет никакого серьезного основания для приложения, чтобы создать экземпляр Помощника class. (CCC 4364208)
- AnySeqHelper.java
- BooleanSeqHelper.java
- CharSeqHelper.java
- DoubleSeqHelper.java
- FloatSeqHelper.java
- LongLongSeqHelper.java
- LongSeqHelper.java
- OctetSeqHelper.java
- ShortSeqHelper.java
- StringValueHelper.java
- ULongLongSeqHelper.java
- ULongSeqHelper.java
- UShortSeqHelper.java
- WCharSeqHelper.java
- WStringValueHelper.java
Чтобы соответствовать недавно переданному выпуску 3015 OMG, который добавляет новый class, AbstractInterfaceDef, чтобы Соединить интерфейсом с классами Репозитария, мы добавили следующие новые константы к org.omg.CORBA.DefinitionKind. Воздействие совместимости: Ни один. (CCC 4367601)
- _dk_AbstractInterface=24. Это - константа, которая указывает, что Объект репозитария Интерфейса представляет абстрактный объект.
- public static final DefinitionKind dk_AbstractInterface = new DefinitionKind(_dk_AbstractInterface). Это - статический экземпляр DefinitionKind, указывая, что Объект репозитария Интерфейса представляет абстрактный интерфейс.
Следующие API org.omg.CORBA для typecodes были изменены, чтобы соответствовать спецификации OMG. Все классы в следующем списке находятся в пакете org.omg.CORBA. Воздействие совместимости: Да. См. каждое изменение ниже для деталей. (CCC 4368800)
- Методы Typecode fixed_digits, fixed_scale, member_visibility, type_modified, и concrete_base_type изменяются от бетона до краткого обзора. Typecode всегда реализуется конструктором ШАРА и никогда не разделяется на подклассы пользователем ШАРА, таким образом, это не должно воздействовать на клиентов.
- TCKind.from_int больше не выдает исключение непроверенное BAD_PARAM. Так как BAD_PARAM является исключением непроверенным, удаляя исключение не должен влиять на потребительский код во время компиляции.
- Principal изменяется на конкретный class с методами, которые бросают NO_IMPLEMENT от абстрактного class с абстрактными методами. Principal осуждается и редко используется. В любом случае это не было бы обычно разделено на подклассы пользователем и будет всегда полностью реализовываться конструктором ШАРА.
- Метод extract_Streamable добавляется к Any. Добавление метода не влияет на совместимость.
- Any.insert_object( object, Typecode ) изменяется, чтобы бросить BAD_PARAM. Так как BAD_PARAM является исключением непроверенным, добавляя, что исключение не должно влиять на потребительский код во время компиляции.
- Методы Any insert_Streamable, extract_Principal, и insert_Principal больше не абстрактны. Any полностью реализуется конструкторами ШАРА и никогда не разделяется на подклассы пользователями ШАРА, таким образом, это не должно воздействовать на клиентов.
- Методы Any extract_value и insert_value изменяются на краткий обзор. Any полностью реализуется конструкторами ШАРА и никогда не разделяется на подклассы пользователями ШАРА, таким образом, это не должно воздействовать на клиентов.
Поле Identifier добавляется к org.omg.CORBA.Initializer. Воздействие совместимости: Ни один. (CCC 4372194)
Чтобы выполнить ptc/00-01-08.pdf, следующие классы изменяются:
- org.omg.CORBA.ORBPackage.InvalidName.java объявляется как финал. Воздействие совместимости: Да. InvalidName объявляется как финал, который воздействовал бы на исходный код, который разделял это на подклассы. Так как это - тип исключения, мы не ожидаем этот вид поведения. (CCC 4366734)
- org.omg.stub.java.rmi._Remote_Stub.java возвращает клона _type_ids. Это предотвратит искажение исходного массива type_ids_ внешними пользователями. (CCC 4366734)
- Метод from_int(Int i) в org.omg.CORBA.SetOverrideType больше не выдает исключение BAD_PARAM. Воздействие совместимости: Нет. Не должен вызвать проблему совместимости, так как мы удаляем объявление бросков исключения непроверенного. (CCC 4369490)
- Метод from_int(Int i) в org.omg.CORBA.DefinitionKind больше не выдает исключение BAD_PARAM. Воздействие совместимости: Нет. (CCC 4370659)
- org.omg.CORBA.DynamicImplementation был осужден OMG в пользу Переносимого Объектного Адаптера (POA). Значение по умолчанию вызывает тело, предоставляется. Воздействие совместимости: Нет. Не должен воздействовать ни на кого, реализовывая этот class. (CCC 4369490)
Следующие классы изменяются, чтобы исправить ошибки. Воздействие совместимости: Нет (CCC 4362556)
- Помощник и классы Держателя добавляются к UnknownUserException.java. Никакое воздействие совместимости.
- Помощник и классы Держателя добавляются к WrongTransaction.java, и class объявляется финалом. Никакое воздействие совместимости.
- CompletionStatus.java не объявляется финалом, больше IDLEntity реализаций, изменяется на частного конструктора. BAD_PARAM RuntimeException больше не будет явно брошен from_int. Воздействие совместимости: Да. Новый код, записанный, используя новый CompletionStatus.java class, не должен будет явно поймать исключение на этапе выполнения BAD_PARAM. Если бы это перекомпилировано с более старым JDK, это получило бы ошибку времени компиляции. - Эти изменения были отменены из-за регресса JCK (4375061). Проблема OMG была зарегистрирована вместо этого (http://www.omg.org/issues/java-rtf.html#Issue3946).
- INV_POLICY.java объявляется как финал. Никакое воздействие совместимости.
Добавление переносимых перехватчиков требует нового метода на существующих API CORBA и четырех новых классов, сгенерированных от определений типов IDL. Воздействие совместимости: ни один, эти изменения не являются всеми дополнениями. (CCC 4379826)
- register_initial_reference добавляется в public class org.omg.CORBA.ORB.
- Новый class org.omg.CORBA.StringSeqHelper добавляется для 2 определений типов IDL.
- Новый class org.omg.CORBA.StringSeqHolder добавляется для 2 определений типов IDL.
- Новый class org.omg.CORBA.WStringSeqHelper добавляется для 2 определений типов IDL.
- Новый class org.omg.CORBA.WStringSeqHolder добавляется для 2 определений типов IDL.

API изменяется на javax.rmi. CORBA

Чтобы выполнить спецификации API OMG, следующие изменения были произведены в javax.rmi.CORBA:

Защищенный конструктор в javax.rmi.CORBA.Stub удаляется. Воздействие совместимости: Ни один. (CCC 4366722)
Чтобы выполнить спецификацию OMG 00-01-06.pdf, конструктор jaxax.rmi.CORBA.ClassDesc удаляется. (CCC 4366734)

Изменения неAPI

Следующие изменения не-API были также реализованы в JDK 5.0.

Корректные вычисления идентификатора репозитария. Воздействие совместимости: Да. Добавленная поддержка управления версиями ШАРА, чтобы позволить функциональную совместимость с JDK 1.3 ШАРА, поддержите назад совместимость, и включите функциональной совместимости с другими ШАРАМИ поставщика. (CCC 4365188)
Чтобы соответствовать недавно переданному выпуску 3015 OMG, мы взяли весь Интерфейс Связанные с репозитарием прагмы версии из org.omg.CORBA.ir.idl. Это также изменяет Значения идентификаторов Репозитария нескольких интерфейсов IR, от которых мы поставляем в org.omg.CORBA, например, IDLTypeHelper,
private static String _id = "IDL:omg.org/CORBA/IDLType:2.3";
к
private static String _id = "IDL:omg.org/CORBA/IDLType:1.0";

Воздействие совместимости: Да. Это изменение могло бы влиять на функциональную совместимость с существующими реализациями. Перезапустите приложение и IR, если Вы получаете исключение COMM_FAILURE (или что-то подобное). (CCC 4372718)
Добавленный @serial exclude тегирует ко всем org.omg.* файлам пакета так, чтобы JAVADOC проигнорировал целый пакет для спецификации Сериализации. Нет никакого требования от Группы по управлению объектами (OMG), чтобы иметь совместимость Сериализации между различными версиями. Фактически разговор там бесполезен случаи, где классы org.omg будут сериализированы в одной версии и десериализованы в следующей версии. Воздействие совместимости: Ни один. (CCC 4394004)
Измененные параметры компилятора idlj в поддержку POA, который является новой функцией CORBA в Мерлине. Изменения к параметрам инструмента idlj включают:
- удаленный недокументированный флаг -poa
- включенная генерация стандартных POA-на-основе скелетов по умолчанию
- добавленный новый флаг, -oldImplBase, чтобы позволить генерацию обратно совместимых скелетов (совместимый с JDK 1.2 и 1.3)
Воздействие совместимости: Да, существующие программы, которые используют компилятор, возможно, должны добавить флаг -oldImplBase к своему вызову idlj, чтобы поддержать совместимость. (CCC 4407835)

Новый API

Следующий новый API был добавлен к JDK 5.0.

API PortableInterceptor добавляется. На неправильную спецификацию, ptc/2000-04-05, ссылались в плане тестирования. Другая неправильная спецификация, orbos/99-12-02 ссылался в списке функций (ptc/2000-04-05 то же самое, поскольку orbos/99-12-02 кроме формата изменился). Корректная ссылка спецификации для этого нового API http://www.omg.org/cgi-gin/doc?ptc/2001-03-04. CCC 4307834 включает список изменений/дополнений от ptc/2000-04-05. Воздействие совместимости: ни один, это не новая функция, таким образом, никакой существующий код не использует ее.
Добавление переносимых перехватчиков требует нового метода, id, в открытом интерфейсе org.omg.PortableServer.POA.

Официальные Спецификации для CORBA поддерживают в J2SE 5.0

Ссылки спецификации

Спецификации, которым Java 2 Платформы Standard Edition (J2SE) подчиняются 5.0 ШАРОВ, следующие. Если эти ссылки не берут Вас к спецификации, на которую ссылаются, OMG, возможно, изменил URL, и можно соединиться с www.omg.org, чтобы искать корректную спецификацию.

CORBA 2.3.1 (formal/99-10-07)
IDL на язык Java, отображающийся (ptc/00-01-08)
Пересмотренный IDL на язык Java, отображающийся (ptc/00-11-03)
Java на язык IDL, отображающийся (ptc/00-01-06)
Взаимодействующая Служба Именования (ptc/00-08-07)
Переносимые Перехватчики (ptc/2001-08-31)

Они - единственные спецификации, на которые ссылается этот документ.

Поддерживаемые Детали Спецификации

Не все вышеупомянутые спецификации в настоящий момент реализуются в ШАРЕ в J2SE 5.0. Точный список поддерживаемых разделов следующие:

CORBA 2.3.1 главы 1-3 и 6-9
Пересмотренный IDL к отображению языка Java, раздел 1.21.8.2, файл orb.properties.
CORBA 2.3.1 главы 4 со следующими заменами от Переносимой спецификации Перехватчиков:
- раздел 4.2.3.5 destroy
- раздел 4.5.2 CodeFactory и PICurrent требуется
- Раздел 4.5.3.4 как обновлено для register_initial_reference
CORBA 2.3.1 главы 5 со следующим обновлением от Переносимой спецификации Перехватчиков:
- 5.5.2 StringSeq и WStringSeq требуются. Это добавляет следующие классы org.omg.CORBA:
- - StringSeqHolder
  - StringSeqHelper
  - WStringSeqHolder
  - WStringSeqHelper
CORBA 2.3.1 раздела 10.6.1 и 10.6.2 поддерживаются для ID репозитария.
CORBA 2.3.1 раздела 10.7 для API TypeCode.
CORBA 2.3.1 главы 11, Переносимый Объектный Адаптер (POA), со следующими обновлениями от Переносимой спецификации Перехватчиков:
- Раздел 11.3.7 POAs должен сохранить все политики
- Раздел 11.3.8.2 снова состояния, что POAs должен сохранить все политики
- Раздел 11.3.8.26 POA:: идентификатор требуется.
CORBA 2.3.1 главы 13 и 15 определяют GIOP 1.0, 1.1, и 1.2. J2SE 5.0 ШАРОВ полностью поддерживают все версии GIOP, за исключением того, что двунаправленная функция GIOP, определенная в разделах 15.8 и 15.9, не поддерживается.
Вся Взаимодействующая Служба Именования поддерживается.
Переносимый раздел Перехватчиков 13.8 (новый Coder/Decoder интерфейсы) и вся глава 21 (спецификация перехватчика).
Раздел 1.21.8 из Пересмотренного IDL к Спецификации Отображения Языка Java (ptc/00-11-03) был изменен от версии в IDL к Спецификации Отображения Языка Java (ptc/00-01-08).

Инструменты

IDL к компилятору Java (idlj) выполняет:
- CORBA 2.3.1 главы 3 (определение IDL)
- CORBA 2.3.1 главы 5 и 6 (семантика типов значения)
- CORBA 2.3.1 раздела 10.6.5 (прагмы)
- IDL к спецификации отображения Java
- Пересмотренный IDL на язык Java, отображающий раздел спецификации 1.12.1" локальных интерфейсов"
Java к компилятору IDL (бэкэнд IIOP для rmic) выполняет:
- CORBA 2.3.1 главы 5 и 6 (оценивают типы),
- Java к отображению языка IDL. Отметьте что это неявно ссылочный раздел 1.21 из IDL к отображению языка Java
- IDL, сгенерированный флагом-idl, выполняет CORBA 2.3.1 главы 3.

Другая информация о Совместимости

class java.util.Calendar не является взаимодействующим между J2SE 1.3.x и J2SE 5.0 при использовании IIOP RMI. Выпуск 3151 OMG может разрешить это, но он должен будет, вероятно, быть реализован в более позднем выпуске платформы Java.
J2SE 5.0 версий Calendar пишет объект ZoneInfo в своем методе writeObject. Точно так же это вызывает readObject, чтобы считать это. Основанный на Сериализации Объекта Java, это ожидает, что, если это говорит с более старой версией, объект не будет там, таким образом, поток бросит EOFException и сохранит потоковую позицию в целости.

Свяжитесь с Нами