@@ -38,71 +38,71 @@ |
||
| 38 | 38 | */ |
| 39 | 39 | class GroupManagement extends Action { |
| 40 | 40 | |
| 41 | - /** |
|
| 42 | - * log add user to group event |
|
| 43 | - * |
|
| 44 | - * @param IGroup $group |
|
| 45 | - * @param IUser $user |
|
| 46 | - */ |
|
| 47 | - public function addUser(IGroup $group, IUser $user) { |
|
| 48 | - $this->log('User "%s" added to group "%s"', |
|
| 49 | - [ |
|
| 50 | - 'group' => $group->getGID(), |
|
| 51 | - 'user' => $user->getUID() |
|
| 52 | - ], |
|
| 53 | - [ |
|
| 54 | - 'user', 'group' |
|
| 55 | - ] |
|
| 56 | - ); |
|
| 57 | - } |
|
| 41 | + /** |
|
| 42 | + * log add user to group event |
|
| 43 | + * |
|
| 44 | + * @param IGroup $group |
|
| 45 | + * @param IUser $user |
|
| 46 | + */ |
|
| 47 | + public function addUser(IGroup $group, IUser $user) { |
|
| 48 | + $this->log('User "%s" added to group "%s"', |
|
| 49 | + [ |
|
| 50 | + 'group' => $group->getGID(), |
|
| 51 | + 'user' => $user->getUID() |
|
| 52 | + ], |
|
| 53 | + [ |
|
| 54 | + 'user', 'group' |
|
| 55 | + ] |
|
| 56 | + ); |
|
| 57 | + } |
|
| 58 | 58 | |
| 59 | - /** |
|
| 60 | - * log remove user from group event |
|
| 61 | - * |
|
| 62 | - * @param IGroup $group |
|
| 63 | - * @param IUser $user |
|
| 64 | - */ |
|
| 65 | - public function removeUser(IGroup $group, IUser $user) { |
|
| 66 | - $this->log('User "%s" removed from group "%s"', |
|
| 67 | - [ |
|
| 68 | - 'group' => $group->getGID(), |
|
| 69 | - 'user' => $user->getUID() |
|
| 70 | - ], |
|
| 71 | - [ |
|
| 72 | - 'user', 'group' |
|
| 73 | - ] |
|
| 74 | - ); |
|
| 75 | - } |
|
| 59 | + /** |
|
| 60 | + * log remove user from group event |
|
| 61 | + * |
|
| 62 | + * @param IGroup $group |
|
| 63 | + * @param IUser $user |
|
| 64 | + */ |
|
| 65 | + public function removeUser(IGroup $group, IUser $user) { |
|
| 66 | + $this->log('User "%s" removed from group "%s"', |
|
| 67 | + [ |
|
| 68 | + 'group' => $group->getGID(), |
|
| 69 | + 'user' => $user->getUID() |
|
| 70 | + ], |
|
| 71 | + [ |
|
| 72 | + 'user', 'group' |
|
| 73 | + ] |
|
| 74 | + ); |
|
| 75 | + } |
|
| 76 | 76 | |
| 77 | - /** |
|
| 78 | - * log create group to group event |
|
| 79 | - * |
|
| 80 | - * @param IGroup $group |
|
| 81 | - */ |
|
| 82 | - public function createGroup(IGroup $group) { |
|
| 83 | - $this->log('Group created: "%s"', |
|
| 84 | - [ |
|
| 85 | - 'group' => $group->getGID() |
|
| 86 | - ], |
|
| 87 | - [ |
|
| 88 | - 'group' |
|
| 89 | - ] |
|
| 90 | - ); |
|
| 91 | - } |
|
| 77 | + /** |
|
| 78 | + * log create group to group event |
|
| 79 | + * |
|
| 80 | + * @param IGroup $group |
|
| 81 | + */ |
|
| 82 | + public function createGroup(IGroup $group) { |
|
| 83 | + $this->log('Group created: "%s"', |
|
| 84 | + [ |
|
| 85 | + 'group' => $group->getGID() |
|
| 86 | + ], |
|
| 87 | + [ |
|
| 88 | + 'group' |
|
| 89 | + ] |
|
| 90 | + ); |
|
| 91 | + } |
|
| 92 | 92 | |
| 93 | - /** |
|
| 94 | - * log delete group to group event |
|
| 95 | - * |
|
| 96 | - * @param IGroup $group |
|
| 97 | - */ |
|
| 98 | - public function deleteGroup(IGroup $group) { |
|
| 99 | - $this->log('Group deleted: "%s"', |
|
| 100 | - [ |
|
| 101 | - 'group' => $group->getGID() |
|
| 102 | - ], |
|
| 103 | - [ |
|
| 104 | - 'group' |
|
| 105 | - ] |
|
| 106 | - ); |
|
| 107 | - } |
|
| 93 | + /** |
|
| 94 | + * log delete group to group event |
|
| 95 | + * |
|
| 96 | + * @param IGroup $group |
|
| 97 | + */ |
|
| 98 | + public function deleteGroup(IGroup $group) { |
|
| 99 | + $this->log('Group deleted: "%s"', |
|
| 100 | + [ |
|
| 101 | + 'group' => $group->getGID() |
|
| 102 | + ], |
|
| 103 | + [ |
|
| 104 | + 'group' |
|
| 105 | + ] |
|
| 106 | + ); |
|
| 107 | + } |
|
| 108 | 108 | } |
@@ -44,165 +44,165 @@ |
||
| 44 | 44 | use Symfony\Component\EventDispatcher\GenericEvent; |
| 45 | 45 | |
| 46 | 46 | class AuditLogger { |
| 47 | - /** @var ILogger */ |
|
| 48 | - private $logger; |
|
| 49 | - /** @var IUserSession */ |
|
| 50 | - private $userSession; |
|
| 51 | - /** @var IGroupManager */ |
|
| 52 | - private $groupManager; |
|
| 53 | - |
|
| 54 | - /** |
|
| 55 | - * AuditLogger constructor. |
|
| 56 | - * |
|
| 57 | - * @param ILogger $logger |
|
| 58 | - * @param IUserSession $userSession |
|
| 59 | - * @param IGroupManager $groupManager |
|
| 60 | - * @param EventDispatcherInterface $eventDispatcher |
|
| 61 | - */ |
|
| 62 | - public function __construct(ILogger $logger, |
|
| 63 | - IUserSession $userSession, |
|
| 64 | - IGroupManager $groupManager, |
|
| 65 | - EventDispatcherInterface $eventDispatcher) { |
|
| 66 | - $this->logger = $logger; |
|
| 67 | - $this->userSession = $userSession; |
|
| 68 | - $this->groupManager = $groupManager; |
|
| 69 | - $this->eventDispatcher = $eventDispatcher; |
|
| 70 | - } |
|
| 71 | - |
|
| 72 | - /** |
|
| 73 | - * Register hooks in order to log them |
|
| 74 | - */ |
|
| 75 | - public function registerHooks() { |
|
| 76 | - $this->userManagementHooks(); |
|
| 77 | - $this->groupHooks(); |
|
| 78 | - $this->sharingHooks(); |
|
| 79 | - $this->authHooks(); |
|
| 80 | - $this->fileHooks(); |
|
| 81 | - $this->trashbinHooks(); |
|
| 82 | - $this->versionsHooks(); |
|
| 83 | - } |
|
| 84 | - |
|
| 85 | - /** |
|
| 86 | - * Connect to user management hooks |
|
| 87 | - */ |
|
| 88 | - private function userManagementHooks() { |
|
| 89 | - $userActions = new UserManagement($this->logger); |
|
| 90 | - |
|
| 91 | - Util::connectHook('OC_User', 'post_createUser', $userActions, 'create'); |
|
| 92 | - Util::connectHook('OC_User', 'post_deleteUser', $userActions, 'delete'); |
|
| 93 | - $this->userSession->listen('\OC\User', 'postSetPassword', [$userActions, 'setPassword']); |
|
| 94 | - } |
|
| 47 | + /** @var ILogger */ |
|
| 48 | + private $logger; |
|
| 49 | + /** @var IUserSession */ |
|
| 50 | + private $userSession; |
|
| 51 | + /** @var IGroupManager */ |
|
| 52 | + private $groupManager; |
|
| 53 | + |
|
| 54 | + /** |
|
| 55 | + * AuditLogger constructor. |
|
| 56 | + * |
|
| 57 | + * @param ILogger $logger |
|
| 58 | + * @param IUserSession $userSession |
|
| 59 | + * @param IGroupManager $groupManager |
|
| 60 | + * @param EventDispatcherInterface $eventDispatcher |
|
| 61 | + */ |
|
| 62 | + public function __construct(ILogger $logger, |
|
| 63 | + IUserSession $userSession, |
|
| 64 | + IGroupManager $groupManager, |
|
| 65 | + EventDispatcherInterface $eventDispatcher) { |
|
| 66 | + $this->logger = $logger; |
|
| 67 | + $this->userSession = $userSession; |
|
| 68 | + $this->groupManager = $groupManager; |
|
| 69 | + $this->eventDispatcher = $eventDispatcher; |
|
| 70 | + } |
|
| 71 | + |
|
| 72 | + /** |
|
| 73 | + * Register hooks in order to log them |
|
| 74 | + */ |
|
| 75 | + public function registerHooks() { |
|
| 76 | + $this->userManagementHooks(); |
|
| 77 | + $this->groupHooks(); |
|
| 78 | + $this->sharingHooks(); |
|
| 79 | + $this->authHooks(); |
|
| 80 | + $this->fileHooks(); |
|
| 81 | + $this->trashbinHooks(); |
|
| 82 | + $this->versionsHooks(); |
|
| 83 | + } |
|
| 84 | + |
|
| 85 | + /** |
|
| 86 | + * Connect to user management hooks |
|
| 87 | + */ |
|
| 88 | + private function userManagementHooks() { |
|
| 89 | + $userActions = new UserManagement($this->logger); |
|
| 90 | + |
|
| 91 | + Util::connectHook('OC_User', 'post_createUser', $userActions, 'create'); |
|
| 92 | + Util::connectHook('OC_User', 'post_deleteUser', $userActions, 'delete'); |
|
| 93 | + $this->userSession->listen('\OC\User', 'postSetPassword', [$userActions, 'setPassword']); |
|
| 94 | + } |
|
| 95 | 95 | |
| 96 | - private function groupHooks() { |
|
| 97 | - $groupActions = new GroupManagement($this->logger); |
|
| 98 | - $this->groupManager->listen('\OC\Group', 'postRemoveUser', [$groupActions, 'removeUser']); |
|
| 99 | - $this->groupManager->listen('\OC\Group', 'postAddUser', [$groupActions, 'addUser']); |
|
| 100 | - $this->groupManager->listen('\OC\Group', 'postDelete', [$groupActions, 'deleteGroup']); |
|
| 101 | - $this->groupManager->listen('\OC\Group', 'postCreate', [$groupActions, 'createGroup']); |
|
| 102 | - } |
|
| 103 | - |
|
| 104 | - /** |
|
| 105 | - * connect to sharing events |
|
| 106 | - */ |
|
| 107 | - private function sharingHooks() { |
|
| 108 | - $shareActions = new Sharing($this->logger); |
|
| 109 | - |
|
| 110 | - Util::connectHook('OCP\Share', 'post_shared', $shareActions, 'shared'); |
|
| 111 | - Util::connectHook('OCP\Share', 'post_unshare', $shareActions, 'unshare'); |
|
| 112 | - Util::connectHook('OCP\Share', 'post_update_permissions', $shareActions, 'updatePermissions'); |
|
| 113 | - Util::connectHook('OCP\Share', 'post_update_password', $shareActions, 'updatePassword'); |
|
| 114 | - Util::connectHook('OCP\Share', 'post_set_expiration_date', $shareActions, 'updateExpirationDate'); |
|
| 115 | - Util::connectHook('OCP\Share', 'share_link_access', $shareActions, 'shareAccessed'); |
|
| 116 | - } |
|
| 117 | - |
|
| 118 | - /** |
|
| 119 | - * connect to authentication event and related actions |
|
| 120 | - */ |
|
| 121 | - private function authHooks() { |
|
| 122 | - $authActions = new Auth($this->logger); |
|
| 123 | - |
|
| 124 | - Util::connectHook('OC_User', 'pre_login', $authActions, 'loginAttempt'); |
|
| 125 | - Util::connectHook('OC_User', 'post_login', $authActions, 'loginSuccessful'); |
|
| 126 | - Util::connectHook('OC_User', 'logout', $authActions, 'logout'); |
|
| 127 | - } |
|
| 128 | - |
|
| 129 | - /** |
|
| 130 | - * Connect to file hooks |
|
| 131 | - */ |
|
| 132 | - private function fileHooks() { |
|
| 133 | - $fileActions = new Files($this->logger); |
|
| 134 | - $this->eventDispatcher->addListener( |
|
| 135 | - IPreview::EVENT, |
|
| 136 | - function(GenericEvent $event) use ($fileActions) { |
|
| 137 | - /** @var File $file */ |
|
| 138 | - $file = $event->getSubject(); |
|
| 139 | - $fileActions->preview([ |
|
| 140 | - 'path' => substr($file->getInternalPath(), 5), |
|
| 141 | - 'width' => $event->getArguments()['width'], |
|
| 142 | - 'height' => $event->getArguments()['height'], |
|
| 143 | - 'crop' => $event->getArguments()['crop'], |
|
| 144 | - 'mode' => $event->getArguments()['mode'] |
|
| 145 | - ]); |
|
| 146 | - } |
|
| 147 | - ); |
|
| 148 | - |
|
| 149 | - Util::connectHook( |
|
| 150 | - Filesystem::CLASSNAME, |
|
| 151 | - Filesystem::signal_post_rename, |
|
| 152 | - $fileActions, |
|
| 153 | - 'rename' |
|
| 154 | - ); |
|
| 155 | - Util::connectHook( |
|
| 156 | - Filesystem::CLASSNAME, |
|
| 157 | - Filesystem::signal_post_create, |
|
| 158 | - $fileActions, |
|
| 159 | - 'create' |
|
| 160 | - ); |
|
| 161 | - Util::connectHook( |
|
| 162 | - Filesystem::CLASSNAME, |
|
| 163 | - Filesystem::signal_post_copy, |
|
| 164 | - $fileActions, |
|
| 165 | - 'copy' |
|
| 166 | - ); |
|
| 167 | - Util::connectHook( |
|
| 168 | - Filesystem::CLASSNAME, |
|
| 169 | - Filesystem::signal_post_write, |
|
| 170 | - $fileActions, |
|
| 171 | - 'write' |
|
| 172 | - ); |
|
| 173 | - Util::connectHook( |
|
| 174 | - Filesystem::CLASSNAME, |
|
| 175 | - Filesystem::signal_post_update, |
|
| 176 | - $fileActions, |
|
| 177 | - 'update' |
|
| 178 | - ); |
|
| 179 | - Util::connectHook( |
|
| 180 | - Filesystem::CLASSNAME, |
|
| 181 | - Filesystem::signal_read, |
|
| 182 | - $fileActions, |
|
| 183 | - 'read' |
|
| 184 | - ); |
|
| 185 | - Util::connectHook( |
|
| 186 | - Filesystem::CLASSNAME, |
|
| 187 | - Filesystem::signal_delete, |
|
| 188 | - $fileActions, |
|
| 189 | - 'delete' |
|
| 190 | - ); |
|
| 191 | - } |
|
| 192 | - |
|
| 193 | - public function versionsHooks() { |
|
| 194 | - $versionsActions = new Versions($this->logger); |
|
| 195 | - Util::connectHook('\OCP\Versions', 'rollback', $versionsActions, 'rollback'); |
|
| 196 | - Util::connectHook('\OCP\Versions', 'delete',$versionsActions, 'delete'); |
|
| 197 | - } |
|
| 198 | - |
|
| 199 | - /** |
|
| 200 | - * Connect to trash bin hooks |
|
| 201 | - */ |
|
| 202 | - private function trashbinHooks() { |
|
| 203 | - $trashActions = new Trashbin($this->logger); |
|
| 204 | - Util::connectHook('\OCP\Trashbin', 'preDelete', $trashActions, 'delete'); |
|
| 205 | - Util::connectHook('\OCA\Files_Trashbin\Trashbin', 'post_restore', $trashActions, 'restore'); |
|
| 206 | - } |
|
| 96 | + private function groupHooks() { |
|
| 97 | + $groupActions = new GroupManagement($this->logger); |
|
| 98 | + $this->groupManager->listen('\OC\Group', 'postRemoveUser', [$groupActions, 'removeUser']); |
|
| 99 | + $this->groupManager->listen('\OC\Group', 'postAddUser', [$groupActions, 'addUser']); |
|
| 100 | + $this->groupManager->listen('\OC\Group', 'postDelete', [$groupActions, 'deleteGroup']); |
|
| 101 | + $this->groupManager->listen('\OC\Group', 'postCreate', [$groupActions, 'createGroup']); |
|
| 102 | + } |
|
| 103 | + |
|
| 104 | + /** |
|
| 105 | + * connect to sharing events |
|
| 106 | + */ |
|
| 107 | + private function sharingHooks() { |
|
| 108 | + $shareActions = new Sharing($this->logger); |
|
| 109 | + |
|
| 110 | + Util::connectHook('OCP\Share', 'post_shared', $shareActions, 'shared'); |
|
| 111 | + Util::connectHook('OCP\Share', 'post_unshare', $shareActions, 'unshare'); |
|
| 112 | + Util::connectHook('OCP\Share', 'post_update_permissions', $shareActions, 'updatePermissions'); |
|
| 113 | + Util::connectHook('OCP\Share', 'post_update_password', $shareActions, 'updatePassword'); |
|
| 114 | + Util::connectHook('OCP\Share', 'post_set_expiration_date', $shareActions, 'updateExpirationDate'); |
|
| 115 | + Util::connectHook('OCP\Share', 'share_link_access', $shareActions, 'shareAccessed'); |
|
| 116 | + } |
|
| 117 | + |
|
| 118 | + /** |
|
| 119 | + * connect to authentication event and related actions |
|
| 120 | + */ |
|
| 121 | + private function authHooks() { |
|
| 122 | + $authActions = new Auth($this->logger); |
|
| 123 | + |
|
| 124 | + Util::connectHook('OC_User', 'pre_login', $authActions, 'loginAttempt'); |
|
| 125 | + Util::connectHook('OC_User', 'post_login', $authActions, 'loginSuccessful'); |
|
| 126 | + Util::connectHook('OC_User', 'logout', $authActions, 'logout'); |
|
| 127 | + } |
|
| 128 | + |
|
| 129 | + /** |
|
| 130 | + * Connect to file hooks |
|
| 131 | + */ |
|
| 132 | + private function fileHooks() { |
|
| 133 | + $fileActions = new Files($this->logger); |
|
| 134 | + $this->eventDispatcher->addListener( |
|
| 135 | + IPreview::EVENT, |
|
| 136 | + function(GenericEvent $event) use ($fileActions) { |
|
| 137 | + /** @var File $file */ |
|
| 138 | + $file = $event->getSubject(); |
|
| 139 | + $fileActions->preview([ |
|
| 140 | + 'path' => substr($file->getInternalPath(), 5), |
|
| 141 | + 'width' => $event->getArguments()['width'], |
|
| 142 | + 'height' => $event->getArguments()['height'], |
|
| 143 | + 'crop' => $event->getArguments()['crop'], |
|
| 144 | + 'mode' => $event->getArguments()['mode'] |
|
| 145 | + ]); |
|
| 146 | + } |
|
| 147 | + ); |
|
| 148 | + |
|
| 149 | + Util::connectHook( |
|
| 150 | + Filesystem::CLASSNAME, |
|
| 151 | + Filesystem::signal_post_rename, |
|
| 152 | + $fileActions, |
|
| 153 | + 'rename' |
|
| 154 | + ); |
|
| 155 | + Util::connectHook( |
|
| 156 | + Filesystem::CLASSNAME, |
|
| 157 | + Filesystem::signal_post_create, |
|
| 158 | + $fileActions, |
|
| 159 | + 'create' |
|
| 160 | + ); |
|
| 161 | + Util::connectHook( |
|
| 162 | + Filesystem::CLASSNAME, |
|
| 163 | + Filesystem::signal_post_copy, |
|
| 164 | + $fileActions, |
|
| 165 | + 'copy' |
|
| 166 | + ); |
|
| 167 | + Util::connectHook( |
|
| 168 | + Filesystem::CLASSNAME, |
|
| 169 | + Filesystem::signal_post_write, |
|
| 170 | + $fileActions, |
|
| 171 | + 'write' |
|
| 172 | + ); |
|
| 173 | + Util::connectHook( |
|
| 174 | + Filesystem::CLASSNAME, |
|
| 175 | + Filesystem::signal_post_update, |
|
| 176 | + $fileActions, |
|
| 177 | + 'update' |
|
| 178 | + ); |
|
| 179 | + Util::connectHook( |
|
| 180 | + Filesystem::CLASSNAME, |
|
| 181 | + Filesystem::signal_read, |
|
| 182 | + $fileActions, |
|
| 183 | + 'read' |
|
| 184 | + ); |
|
| 185 | + Util::connectHook( |
|
| 186 | + Filesystem::CLASSNAME, |
|
| 187 | + Filesystem::signal_delete, |
|
| 188 | + $fileActions, |
|
| 189 | + 'delete' |
|
| 190 | + ); |
|
| 191 | + } |
|
| 192 | + |
|
| 193 | + public function versionsHooks() { |
|
| 194 | + $versionsActions = new Versions($this->logger); |
|
| 195 | + Util::connectHook('\OCP\Versions', 'rollback', $versionsActions, 'rollback'); |
|
| 196 | + Util::connectHook('\OCP\Versions', 'delete',$versionsActions, 'delete'); |
|
| 197 | + } |
|
| 198 | + |
|
| 199 | + /** |
|
| 200 | + * Connect to trash bin hooks |
|
| 201 | + */ |
|
| 202 | + private function trashbinHooks() { |
|
| 203 | + $trashActions = new Trashbin($this->logger); |
|
| 204 | + Util::connectHook('\OCP\Trashbin', 'preDelete', $trashActions, 'delete'); |
|
| 205 | + Util::connectHook('\OCA\Files_Trashbin\Trashbin', 'post_restore', $trashActions, 'restore'); |
|
| 206 | + } |
|
| 207 | 207 | |
| 208 | 208 | } |
@@ -88,17 +88,17 @@ discard block |
||
| 88 | 88 | private function userManagementHooks() { |
| 89 | 89 | $userActions = new UserManagement($this->logger); |
| 90 | 90 | |
| 91 | - Util::connectHook('OC_User', 'post_createUser', $userActions, 'create'); |
|
| 92 | - Util::connectHook('OC_User', 'post_deleteUser', $userActions, 'delete'); |
|
| 91 | + Util::connectHook('OC_User', 'post_createUser', $userActions, 'create'); |
|
| 92 | + Util::connectHook('OC_User', 'post_deleteUser', $userActions, 'delete'); |
|
| 93 | 93 | $this->userSession->listen('\OC\User', 'postSetPassword', [$userActions, 'setPassword']); |
| 94 | 94 | } |
| 95 | 95 | |
| 96 | - private function groupHooks() { |
|
| 96 | + private function groupHooks() { |
|
| 97 | 97 | $groupActions = new GroupManagement($this->logger); |
| 98 | - $this->groupManager->listen('\OC\Group', 'postRemoveUser', [$groupActions, 'removeUser']); |
|
| 99 | - $this->groupManager->listen('\OC\Group', 'postAddUser', [$groupActions, 'addUser']); |
|
| 100 | - $this->groupManager->listen('\OC\Group', 'postDelete', [$groupActions, 'deleteGroup']); |
|
| 101 | - $this->groupManager->listen('\OC\Group', 'postCreate', [$groupActions, 'createGroup']); |
|
| 98 | + $this->groupManager->listen('\OC\Group', 'postRemoveUser', [$groupActions, 'removeUser']); |
|
| 99 | + $this->groupManager->listen('\OC\Group', 'postAddUser', [$groupActions, 'addUser']); |
|
| 100 | + $this->groupManager->listen('\OC\Group', 'postDelete', [$groupActions, 'deleteGroup']); |
|
| 101 | + $this->groupManager->listen('\OC\Group', 'postCreate', [$groupActions, 'createGroup']); |
|
| 102 | 102 | } |
| 103 | 103 | |
| 104 | 104 | /** |
@@ -193,7 +193,7 @@ discard block |
||
| 193 | 193 | public function versionsHooks() { |
| 194 | 194 | $versionsActions = new Versions($this->logger); |
| 195 | 195 | Util::connectHook('\OCP\Versions', 'rollback', $versionsActions, 'rollback'); |
| 196 | - Util::connectHook('\OCP\Versions', 'delete',$versionsActions, 'delete'); |
|
| 196 | + Util::connectHook('\OCP\Versions', 'delete', $versionsActions, 'delete'); |
|
| 197 | 197 | } |
| 198 | 198 | |
| 199 | 199 | /** |