Класс CommandInfo
- java.lang.Object
-
- javax.activation.CommandInfo
public class CommandInfo extends Object
Класс CommandInfo используется реализациями CommandMap для описания результатов запросов команд. Он предоставляет запрашивающему как глагол запроса, так и экземпляр компонента bean. Также есть метод, возвращающий имя класса, реализующего команду, но он не гарантирует возвращение действительного значения. Причина этого заключается в том, чтобы позволить реализациям CommandMap, наследующим CommandInfo, предоставлять специальное поведение. Например, CommandMap может динамически генерировать JavaBeans. В этом случае может быть невозможно создать объект со всей необходимой информацией состояния только по имени класса.
- С момента:
- 1.6
Конструкторы
| Конструктор и описание |
|---|
CommandInfo(String verb,
String className) Конструктор для CommandInfo. |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
String |
getCommandClass() Возвращает имя класса команды. |
String |
getCommandName() Возвращает глагол команды. |
Object |
getCommandObject(DataHandler dh,
ClassLoader loader) Возвращает экземпляр компонента JavaBean. |
Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Конструкторы
CommandInfo
public CommandInfo(String verb,
String className)
Конструктор для CommandInfo.
- Параметры:
-
verb- Глагол команды, описываемый этим CommandInfo. -
className- Полное имя класса команды.
Методы
getCommandName
public String getCommandName()
Возвращает глагол команды.
- Возвращает:
- глагол команды.
getCommandClass
public String getCommandClass()
Возвращает имя класса команды. Этот метод МОЖЕТ вернуть null в случаях, когда CommandMap переопределил CommandInfo для собственных целей. Другими словами, может быть невозможно создать правильное состояние в команде, просто зная ее имя класса. НЕ СЛЕДУЕТ ЗАВИСИТЬ ОТ ТОГО, ЧТО ЭТОТ МЕТОД ВОЗВРАЩАЕТ ДЕЙСТВИТЕЛЬНОЕ ЗНАЧЕНИЕ!
- Возвращает:
- Имя класса команды или null
getCommandObject
public Object getCommandObject(DataHandler dh,
ClassLoader loader)
throws IOException,
ClassNotFoundException
Возвращает экземпляр компонента JavaBean.
Начните с инициализации компонента с помощью Beans.instantiate().
Если компонент реализует интерфейс javax.activation.CommandObject, вызовите его метод setCommandContext.
Если параметр DataHandler равен null, то компонент инициализируется без данных. ПРИМЕЧАНИЕ: это может быть полезно, если по какой-то причине DataHandler, переданный в метод, вызывает исключения IOException при попытке получить свой InputStream. Это позволит вызывающей стороне получить ссылку на компонент, если он может быть инициализирован.
Если компонент НЕ реализует интерфейс CommandObject, этот метод проверит, реализует ли он интерфейс java.io.Externalizable. Если да, вызовется метод readExternal компонента, если из DataHandler можно получить InputStream.
- Параметры:
-
dh- DataHandler, описывающий данные, которые должны быть переданы команде. -
loader- ClassLoader, который будет использоваться для инициализации компонента. - Возвращает:
- Компонент
- Исключение:
IOExceptionClassNotFoundException- См. также:
-
Beans.instantiate(java.lang.ClassLoader, java.lang.String),CommandObject
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.