| Classes in this File | Line Coverage | Branch Coverage | Complexity | ||||
| PBLifeCycleEvent |
|
| 2.6923076923076925;2.692 | ||||
| PBLifeCycleEvent$Type |
|
| 2.6923076923076925;2.692 |
| 1 | package org.apache.ojb.broker; | |
| 2 | ||
| 3 | /* Copyright 2003-2005 The Apache Software Foundation | |
| 4 | * | |
| 5 | * Licensed under the Apache License, Version 2.0 (the "License"); | |
| 6 | * you may not use this file except in compliance with the License. | |
| 7 | * You may obtain a copy of the License at | |
| 8 | * | |
| 9 | * http://www.apache.org/licenses/LICENSE-2.0 | |
| 10 | * | |
| 11 | * Unless required by applicable law or agreed to in writing, software | |
| 12 | * distributed under the License is distributed on an "AS IS" BASIS, | |
| 13 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
| 14 | * See the License for the specific language governing permissions and | |
| 15 | * limitations under the License. | |
| 16 | */ | |
| 17 | ||
| 18 | import org.apache.commons.lang.builder.ToStringBuilder; | |
| 19 | import org.apache.commons.lang.builder.ToStringStyle; | |
| 20 | ||
| 21 | /** | |
| 22 | * The <code>PBLifeCycleEvent</code> encapsulates information about | |
| 23 | * the life-cycle of a persistent object. | |
| 24 | * <br/> | |
| 25 | * NOTE: | |
| 26 | * <br/> | |
| 27 | * Because of performance reasons OJB intern reuse instances of this class | |
| 28 | * by reset target object. | |
| 29 | * | |
| 30 | * @author Armin Waibel | |
| 31 | * @version $Id: PBLifeCycleEvent.java,v 1.1 2007-08-24 22:17:36 ewestfal Exp $ | |
| 32 | */ | |
| 33 | public final class PBLifeCycleEvent extends PersistenceBrokerEvent | |
| 34 | { | |
| 35 | /** Denotes an event that happens before the insertion of an object. */ | |
| 36 | public static final int TYPE_BEFORE_INSERT = 1; | |
| 37 | /** Denotes an event that happens before the deletion of an object. */ | |
| 38 | public static final int TYPE_BEFORE_DELETE = 2; | |
| 39 | /** Denotes an event that happens before the update of an object. */ | |
| 40 | public static final int TYPE_BEFORE_UPDATE = 3; | |
| 41 | /** Denotes an event that happens after the update of an object. */ | |
| 42 | public static final int TYPE_AFTER_UPDATE = 4; | |
| 43 | /** Denotes an event that happens after the deletion of an object. */ | |
| 44 | public static final int TYPE_AFTER_DELETE = 5; | |
| 45 | /** Denotes an event that happens after the lookup of an object. */ | |
| 46 | public static final int TYPE_AFTER_LOOKUP = 6; | |
| 47 | /** Denotes an event that happens after the insertion of an object. */ | |
| 48 | public static final int TYPE_AFTER_INSERT = 7; | |
| 49 | ||
| 50 | private Type eventType; | |
| 51 | private Object target; | |
| 52 | ||
| 53 | /** | |
| 54 | * Creates a new event instance. | |
| 55 | * | |
| 56 | * @param broker The broker | |
| 57 | * @param target The object which caused the event | |
| 58 | * @param eventType The type of the event | |
| 59 | */ | |
| 60 | public PBLifeCycleEvent(PersistenceBroker broker, Object target, Type eventType) | |
| 61 | { | |
| 62 | super(broker); | |
| 63 | this.target = target; | |
| 64 | this.eventType = eventType; | |
| 65 | } | |
| 66 | ||
| 67 | /** | |
| 68 | * Creates a new event instance. | |
| 69 | * | |
| 70 | * @param broker The broker | |
| 71 | * @param type The type of the event | |
| 72 | */ | |
| 73 | public PBLifeCycleEvent(PersistenceBroker broker, Type type) | |
| 74 | { | |
| 75 | super(broker); | |
| 76 | this.eventType = type; | |
| 77 | } | |
| 78 | ||
| 79 | /** | |
| 80 | * Returns the target object as an instance of {@link PersistenceBrokerAware} if possible. | |
| 81 | * | |
| 82 | * @return The {@link PersistenceBrokerAware} instance if there is a target and it implements | |
| 83 | * this interface | |
| 84 | */ | |
| 85 | public PersistenceBrokerAware getPersitenceBrokerAware() | |
| 86 | { | |
| 87 | if ((target != null) && (target instanceof PersistenceBrokerAware)) | |
| 88 | { | |
| 89 | return (PersistenceBrokerAware)target; | |
| 90 | } | |
| 91 | else | |
| 92 | { | |
| 93 | return null; | |
| 94 | } | |
| 95 | } | |
| 96 | ||
| 97 | /** | |
| 98 | * Set the object that caused the event. | |
| 99 | * | |
| 100 | * @param obj The object | |
| 101 | */ | |
| 102 | public void setTarget(Object obj) | |
| 103 | { | |
| 104 | this.target = obj; | |
| 105 | } | |
| 106 | ||
| 107 | /** | |
| 108 | * Returns the object that caused the event. | |
| 109 | * | |
| 110 | * @return The object | |
| 111 | */ | |
| 112 | public Object getTarget() | |
| 113 | { | |
| 114 | return target; | |
| 115 | } | |
| 116 | ||
| 117 | /** | |
| 118 | * {@inheritDoc} | |
| 119 | */ | |
| 120 | public String toString() | |
| 121 | { | |
| 122 | ToStringBuilder buf = new ToStringBuilder(this, ToStringStyle.MULTI_LINE_STYLE); | |
| 123 | buf.append("target object", target). | |
| 124 | append("source object", getSource()). | |
| 125 | append("eventType", eventType.toString()); | |
| 126 | return buf.toString(); | |
| 127 | } | |
| 128 | ||
| 129 | /** | |
| 130 | * Returns the event type. | |
| 131 | * | |
| 132 | * @return The event type | |
| 133 | */ | |
| 134 | public Type getEventType() | |
| 135 | { | |
| 136 | return eventType; | |
| 137 | } | |
| 138 | ||
| 139 | /** | |
| 140 | * Enum-like class for the event types. | |
| 141 | */ | |
| 142 | public static class Type | |
| 143 | { | |
| 144 | /** Denotes an event that happens before the insertion of an object. */ | |
| 145 | public static final Type BEFORE_INSERT = new Type(TYPE_BEFORE_INSERT); | |
| 146 | /** Denotes an event that happens before the update of an object. */ | |
| 147 | public static final Type BEFORE_UPDATE = new Type(TYPE_BEFORE_UPDATE); | |
| 148 | /** Denotes an event that happens after the insertion of an object. */ | |
| 149 | public static final Type AFTER_INSERT = new Type(TYPE_AFTER_INSERT); | |
| 150 | /** Denotes an event that happens after the update of an object. */ | |
| 151 | public static final Type AFTER_UPDATE = new Type(TYPE_AFTER_UPDATE); | |
| 152 | /** Denotes an event that happens before the deletion of an object. */ | |
| 153 | public static final Type BEFORE_DELETE = new Type(TYPE_BEFORE_DELETE); | |
| 154 | /** Denotes an event that happens after the deletion of an object. */ | |
| 155 | public static final Type AFTER_DELETE = new Type(TYPE_AFTER_DELETE); | |
| 156 | /** Denotes an event that happens after the lookup of an object. */ | |
| 157 | public static final Type AFTER_LOOKUP = new Type(TYPE_AFTER_LOOKUP); | |
| 158 | ||
| 159 | private int type; | |
| 160 | ||
| 161 | /** | |
| 162 | * Creates a new instance. | |
| 163 | * | |
| 164 | * @param type The type value | |
| 165 | */ | |
| 166 | protected Type(int type) | |
| 167 | { | |
| 168 | this.type = type; | |
| 169 | } | |
| 170 | ||
| 171 | /** | |
| 172 | * {@inheritDoc} | |
| 173 | */ | |
| 174 | public final boolean equals(Object obj) | |
| 175 | { | |
| 176 | if (obj == this) | |
| 177 | { | |
| 178 | return true; | |
| 179 | } | |
| 180 | if (!(obj instanceof PBStateEvent)) | |
| 181 | { | |
| 182 | return false; | |
| 183 | } | |
| 184 | ||
| 185 | return type == ((Type) obj).type; | |
| 186 | } | |
| 187 | ||
| 188 | /** | |
| 189 | * {@inheritDoc} | |
| 190 | */ | |
| 191 | public final int hashCode() | |
| 192 | { | |
| 193 | return type; | |
| 194 | } | |
| 195 | ||
| 196 | /** | |
| 197 | * Returns the type id. | |
| 198 | * | |
| 199 | * @return The type id | |
| 200 | */ | |
| 201 | public final int typeId() | |
| 202 | { | |
| 203 | return type; | |
| 204 | } | |
| 205 | ||
| 206 | /** | |
| 207 | * {@inheritDoc} | |
| 208 | */ | |
| 209 | public String toString() | |
| 210 | { | |
| 211 | return this.getClass().getName() + " [type= " + typeAsName(type) + "]"; | |
| 212 | } | |
| 213 | ||
| 214 | private static String typeAsName(int type) | |
| 215 | { | |
| 216 | if (type == TYPE_AFTER_DELETE) | |
| 217 | { | |
| 218 | return "AFTER_DELETE"; | |
| 219 | } | |
| 220 | else if (type == TYPE_AFTER_LOOKUP) | |
| 221 | { | |
| 222 | return "AFTER_LOOKUP"; | |
| 223 | } | |
| 224 | else if (type == TYPE_AFTER_INSERT) | |
| 225 | { | |
| 226 | return "AFTER_INSERT"; | |
| 227 | } | |
| 228 | else if (type == TYPE_AFTER_UPDATE) | |
| 229 | { | |
| 230 | return "AFTER_UPDATE"; | |
| 231 | } | |
| 232 | else if (type == TYPE_BEFORE_DELETE) | |
| 233 | { | |
| 234 | return "BEFORE_DELETE"; | |
| 235 | } | |
| 236 | else if (type == TYPE_BEFORE_INSERT) | |
| 237 | { | |
| 238 | return "BEFORE_INSERT"; | |
| 239 | } | |
| 240 | else if (type == TYPE_BEFORE_UPDATE) | |
| 241 | { | |
| 242 | return "BEFORE_UPDATE"; | |
| 243 | } | |
| 244 | else | |
| 245 | { | |
| 246 | throw new OJBRuntimeException("Could not find type with typeId " + type); | |
| 247 | } | |
| 248 | } | |
| 249 | } | |
| 250 | } |