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

javax.jms
Интерфейс ConnectionFactory

Все Известные Подынтерфейсы:

QueueConnectionFactory, TopicConnectionFactory, XAQueueConnectionFactory, XATopicConnectionFactory

public interface ConnectionFactory

A ConnectionFactory объект инкапсулирует ряд параметров конфигурации соединения, который был определен администратором. Клиент использует это, чтобы создать соединение с провайдером JMS.

A ConnectionFactory объект является JMS администрируемый объект и поддерживает параллельное использование.

Администрируемые объекты JMS являются объектами, содержащими конфигурационную информацию, которые создаются администратором и позже используются клиентами JMS. Они делают практичным, чтобы администрировать API JMS в предприятии.

Хотя интерфейсы для администрируемых объектов явно не зависят от Интерфейса Именования и Каталога Java (JNDI) API, API JMS устанавливает соглашение, что клиенты JMS находят администрируемые объекты, ища их в пространстве имен JNDI.

Администратор может поместить администрируемый объект куда угодно в пространство имен. API JMS не определяет политику именования.

Ожидается, что провайдеры JMS обеспечат инструменты, администратор должен создать и сконфигурировать администрируемые объекты в пространстве имен JNDI. Реализации провайдера JMS администрируемых объектов должны быть обоими javax.jndi.Referenceable и java.io.Serializable так, чтобы они могли быть сохранены во всех контекстах именования JNDI. Кроме того, рекомендуется, чтобы эти реализации следовали за шаблонами разработки ^JavaBeansTM.

Эта стратегия предоставляет несколько преимуществ:

• Это скрывает специфичные для провайдера детали от клиентов JMS.
• Это абстрагирует административную информацию в объекты в языке программирования Java ("объекты Java"), которые легко организуются и администрируемы от общей консоли управления.
• С тех пор будут провайдеры JNDI для всех популярных служб именования, это означает, что провайдеры JMS могут поставить одну реализацию администрируемых объектов, которые будут работать всюду.

Администрируемый объект не должен держаться ни за какие удаленные ресурсы. Его поиск не должен использовать удаленные ресурсы кроме используемых API JNDI непосредственно.

Клиенты должны думать об администрируемых объектах как о локальных объектах Java. У поиска их не должно быть никаких скрытых побочных эффектов или использования удивительное количество локальных ресурсов.

См. Также:

Connection, QueueConnectionFactory, TopicConnectionFactory

Сводка метода

Соединение	createConnection() Создает соединение с пользовательскими идентификационными данными значения по умолчанию.
Соединение	createConnection(java.lang.String userName, java.lang.String password) Создает соединение с указанными пользовательскими идентификационными данными.

Деталь метода

createConnection

Connection createConnection()
                            throws JMSException

Создает соединение с пользовательскими идентификационными данными значения по умолчанию. Соединение создается в остановленном режиме. Никакие сообщения будут переданы до Connection.start метод явно вызывают.

Возвраты:

недавно создаваемое соединение

Броски:

JMSException - если провайдер JMS не в состоянии создать соединение из-за некоторой внутренней ошибки.

JMSSecurityException - если аутентификация клиента перестала работать из-за недопустимого имени пользователя или пароля.

С тех пор:

1.1

createConnection

Connection createConnection(java.lang.String userName,
                            java.lang.String password)
                            throws JMSException

Создает соединение с указанными пользовательскими идентификационными данными. Соединение создается в остановленном режиме. Никакие сообщения будут переданы до Connection.start метод явно вызывают.

Параметры:

userName - имя пользователя вызывающей стороны

password - пароль вызывающей стороны

Возвраты:

недавно создаваемое соединение

Броски:

JMSException - если провайдер JMS не в состоянии создать соединение из-за некоторой внутренней ошибки.

JMSSecurityException - если аутентификация клиента перестала работать из-за недопустимого имени пользователя или пароля.

С тех пор:

1.1