CBaseUserIdentity
| Пакет | system.web.auth |
|---|---|
| Наследование | абстрактный класс CBaseUserIdentity » CComponent |
| Реализует | IUserIdentity |
| Подклассы | CUserIdentity |
| С | 1.0 |
| Исходный код | framework/web/auth/CBaseUserIdentity.php |
CBaseUserIdentity реализует схему представления информации об идентичности, которая должна быть сохранена. Он также предоставляет способ представления ошибок аутентификации.
Производные классы должны реализовывать IUserIdentity::authenticate и IUserIdentity::getId, которые необходимы интерфейсу IUserIdentity.
Свойства публичного доступа
| Свойство | Тип | Описание | Определено в |
|---|---|---|---|
| errorCode | integer | код ошибки аутентификации. Если произошла ошибка, код ошибки будет отличным от нуля. По умолчанию равен 100, означающему неизвестную идентичность. Вызов authenticate изменит это значение. | CBaseUserIdentity |
| errorMessage | string | сообщение об ошибке аутентификации. По умолчанию пустая строка. | CBaseUserIdentity |
| id | mixed | Возвращает значение, которое однозначно идентифицирует пользователя. | CBaseUserIdentity |
| isAuthenticated | boolean | Возвращает значение, указывающее, аутентифицирована ли идентичность. | CBaseUserIdentity |
| name | string | Возвращает отображаемое имя для идентичности (например, имя пользователя). | CBaseUserIdentity |
| persistentStates | array | Возвращает состояния идентичности, которые должны быть сохранены. | CBaseUserIdentity |
Методы публичного доступа
| Метод | Описание | Определено в |
|---|---|---|
| __call() | Вызывает метод по имени, который не является методом класса. | CComponent |
| __get() | Возвращает значение свойства, список обработчиков событий или компонент на основе его имени. | CComponent |
| __isset() | Проверяет, является ли значение свойства null. | CComponent |
| __set() | Устанавливает значение свойства компонента. | CComponent |
| __unset() | Устанавливает свойство компонента в null. | CComponent |
| asa() | Возвращает объект поведения по имени. | CComponent |
| attachBehavior() | Присоединяет поведение к этому компоненту. | CComponent |
| attachBehaviors() | Присоединяет список поведений к компоненту. | CComponent |
| attachEventHandler() | Присоединяет обработчик событий к событию. | CComponent |
| authenticate() | Аутентифицирует пользователя. | IUserIdentity |
| canGetProperty() | Определяет, можно ли прочитать свойство. | CComponent |
| canSetProperty() | Определяет, можно ли установить свойство. | CComponent |
| clearState() | Удаляет указанное состояние. | CBaseUserIdentity |
| detachBehavior() | Отсоединяет поведение от компонента. | CComponent |
| detachBehaviors() | Отсоединяет все поведения от компонента. | CComponent |
| detachEventHandler() | Отсоединяет существующий обработчик событий. | CComponent |
| disableBehavior() | Отключает прикреплённое поведение. | CComponent |
| disableBehaviors() | Отключает все прикрепленные к этому компоненту поведения. | CComponent |
| enableBehavior() | Включает прикреплённое поведение. | CComponent |
| enableBehaviors() | Включает все прикреплённые к этому компоненту поведения. | CComponent |
| evaluateExpression() | Вычисляет выражение PHP или обратный вызов в контексте этого компонента. | CComponent |
| getEventHandlers() | Возвращает список прикрепленных обработчиков событий для события. | CComponent |
| getId() | Возвращает значение, которое однозначно идентифицирует пользователя. | CBaseUserIdentity |
| getIsAuthenticated() | Возвращает значение, указывающее, аутентифицирована ли идентичность. | CBaseUserIdentity |
| getName() | Возвращает отображаемое имя для идентичности (например, имя пользователя). | CBaseUserIdentity |
| getPersistentStates() | Возвращает состояния идентичности, которые должны быть сохранены. | CBaseUserIdentity |
| getState() | Получает сохраненное состояние по указанному имени. | CBaseUserIdentity |
| hasEvent() | Определяет, определено ли событие. | CComponent |
| hasEventHandler() | Проверяет, есть ли обработчики для события с указанным именем. | CComponent |
| hasProperty() | Определяет, определено ли свойство. | CComponent |
| raiseEvent() | Вызывает событие. | CComponent |
| setPersistentStates() | Устанавливает массив сохранённых состояний. | CBaseUserIdentity |
| setState() | Устанавливает состояние с указанным именем и значением. | CBaseUserIdentity |
Подробное описание свойств
errorCode свойство
public integer $errorCode;
код ошибки аутентификации. Если произошла ошибка, код ошибки будет отличным от нуля. По умолчанию равен 100, означающему неизвестную идентичность. Вызов authenticate изменит это значение.
errorMessage свойство
public string $errorMessage;
сообщение об ошибке аутентификации. По умолчанию пустая строка.
id свойство только для чтения
public mixed getId()
Возвращает значение, которое однозначно идентифицирует пользователя.
isAuthenticated свойство только для чтения
public boolean getIsAuthenticated()
Возвращает значение, указывающее, аутентифицирована ли идентичность. Этот метод необходим интерфейсу IUserIdentity.
name свойство только для чтения
public string getName()
Возвращает отображаемое имя для идентичности (например, имя пользователя).
persistentStates свойство
public array getPersistentStates()
public void setPersistentStates(array $states)
Возвращает состояния идентичности, которые должны быть сохранены. Этот метод необходим интерфейсу IUserIdentity.
Подробное описание методов
clearState() метод
public void clearState(string $name) | ||
| $name | string | имя состояния |
public function clearState($name)
{
unset($this->_state[$name]);
}
Удаляет указанное состояние.
getId() метод
public mixed getId() | ||
| {возвращает} | смешанный тип | значение, уникально представляющее идентификатор (например, значение первичного ключа). Реализация по умолчанию просто возвращает имя. |
public function getId()
{
return $this->getName();
}
Возвращает значение, уникально представляющее идентификатор.
getIsAuthenticated() метод
public boolean getIsAuthenticated() | ||
| {возвращает} | булево | успешность аутентификации. |
public function getIsAuthenticated()
{
return $this->errorCode==self::ERROR_NONE;
}
Возвращает значение, указывающее, аутентифицирован ли идентификатор. Этот метод необходим для IUserIdentity.
getName() метод
public string getName() | ||
| {возвращает} | строка | отображаемое имя идентификатора. Реализация по умолчанию просто возвращает пустую строку. |
public function getName()
{
return '';
}
Возвращает отображаемое имя идентификатора (например, имя пользователя).
getPersistentStates() метод
public array getPersistentStates() | ||
| {возвращает} | массив | состояния идентификатора, которые должны сохраняться. |
public function getPersistentStates()
{
return $this->_state;
}
Возвращает состояния идентификатора, которые должны сохраняться. Этот метод необходим для IUserIdentity.
getState() метод
public mixed getState(string $name, mixed $defaultValue=NULL) | ||
| $name | строка | имя состояния |
| $defaultValue | смешанный тип | значение по умолчанию, которое будет возвращено, если состояние с заданным именем не существует |
| {возвращает} | смешанный тип | значение состояния с заданным именем |
public function getState($name,$defaultValue=null)
{
return isset($this->_state[$name])?$this->_state[$name]:$defaultValue;
}
Получает сохраненное состояние по указанному имени.
setPersistentStates() метод
public void setPersistentStates(array $states) | ||
| $states | массив | состояния идентификатора, которые должны сохраняться. |
public function setPersistentStates($states)
{
$this->_state = $states;
}
Устанавливает массив постоянных состояний.
setState() метод
public void setState(string $name, mixed $value) | ||
| $name | строка | имя состояния |
| $value | смешанный тип | значение состояния с заданным именем |
public function setState($name,$value)
{
$this->_state[$name]=$value;
}
Устанавливает состояние с заданным именем и значением.
© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc/api/1.1/CBaseUserIdentity