Refactor paths

orbit · Mar 30, 2016 · c3c4947 · c3c4947
1 parent 42bc900
commit c3c4947
Show file tree

Hide file tree

Showing 410 changed files with 8,867 additions and 6,864 deletions.
diff --git a/.../main/java/com/ea/orbit/actors/Actor.java → ...c/main/java/cloud/orbit/actors/Actor.java b/.../main/java/com/ea/orbit/actors/Actor.java → ...c/main/java/cloud/orbit/actors/Actor.java
@@ -1,35 +1,35 @@
 /*
-Copyright (C) 2015 Electronic Arts Inc.  All rights reserved.
+ Copyright (C) 2016 Electronic Arts Inc.  All rights reserved.
 
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions
-are met:
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
 
-1.  Redistributions of source code must retain the above copyright
-    notice, this list of conditions and the following disclaimer.
-2.  Redistributions in binary form must reproduce the above copyright
-    notice, this list of conditions and the following disclaimer in the
-    documentation and/or other materials provided with the distribution.
-3.  Neither the name of Electronic Arts, Inc. ("EA") nor the names of
-    its contributors may be used to endorse or promote products derived
-    from this software without specific prior written permission.
+ 1.  Redistributions of source code must retain the above copyright
+     notice, this list of conditions and the following disclaimer.
+ 2.  Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimer in the
+     documentation and/or other materials provided with the distribution.
+ 3.  Neither the name of Electronic Arts, Inc. ("EA") nor the names of
+     its contributors may be used to endorse or promote products derived
+     from this software without specific prior written permission.
 
-THIS SOFTWARE IS PROVIDED BY ELECTRONIC ARTS AND ITS CONTRIBUTORS "AS IS" AND ANY
-EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL ELECTRONIC ARTS OR ITS CONTRIBUTORS BE LIABLE FOR ANY
-DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
-(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
-THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-*/
+ THIS SOFTWARE IS PROVIDED BY ELECTRONIC ARTS AND ITS CONTRIBUTORS "AS IS" AND ANY
+ EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL ELECTRONIC ARTS OR ITS CONTRIBUTORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
 
-package com.ea.orbit.actors;
+package cloud.orbit.actors;
 
-import com.ea.orbit.actors.annotation.NoIdentity;
-import com.ea.orbit.actors.runtime.DefaultDescriptorFactory;
+import cloud.orbit.actors.annotation.NoIdentity;
+import cloud.orbit.actors.runtime.DefaultDescriptorFactory;
 
 /**
  * Interface marker for orbit actors.

diff --git a/...va/com/ea/orbit/actors/ActorObserver.java → ...ava/cloud/orbit/actors/ActorObserver.java b/...va/com/ea/orbit/actors/ActorObserver.java → ...ava/cloud/orbit/actors/ActorObserver.java
@@ -1,37 +1,37 @@
 /*
-Copyright (C) 2015 Electronic Arts Inc.  All rights reserved.
+ Copyright (C) 2016 Electronic Arts Inc.  All rights reserved.
 
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions
-are met:
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
 
-1.  Redistributions of source code must retain the above copyright
-    notice, this list of conditions and the following disclaimer.
-2.  Redistributions in binary form must reproduce the above copyright
-    notice, this list of conditions and the following disclaimer in the
-    documentation and/or other materials provided with the distribution.
-3.  Neither the name of Electronic Arts, Inc. ("EA") nor the names of
-    its contributors may be used to endorse or promote products derived
-    from this software without specific prior written permission.
+ 1.  Redistributions of source code must retain the above copyright
+     notice, this list of conditions and the following disclaimer.
+ 2.  Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimer in the
+     documentation and/or other materials provided with the distribution.
+ 3.  Neither the name of Electronic Arts, Inc. ("EA") nor the names of
+     its contributors may be used to endorse or promote products derived
+     from this software without specific prior written permission.
 
-THIS SOFTWARE IS PROVIDED BY ELECTRONIC ARTS AND ITS CONTRIBUTORS "AS IS" AND ANY
-EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL ELECTRONIC ARTS OR ITS CONTRIBUTORS BE LIABLE FOR ANY
-DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
-(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
-THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-*/
+ THIS SOFTWARE IS PROVIDED BY ELECTRONIC ARTS AND ITS CONTRIBUTORS "AS IS" AND ANY
+ EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL ELECTRONIC ARTS OR ITS CONTRIBUTORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
 
-package com.ea.orbit.actors;
+package cloud.orbit.actors;
 
 
-import com.ea.orbit.actors.cluster.NodeAddress;
-import com.ea.orbit.actors.runtime.DefaultDescriptorFactory;
-import com.ea.orbit.concurrent.Task;
+import cloud.orbit.actors.cluster.NodeAddress;
+import cloud.orbit.actors.runtime.DefaultDescriptorFactory;
+import cloud.orbit.concurrent.Task;
 
 /**
  * Used to create interfaces to client objects that can be passed as remote references to actors.

diff --git a/actors/core/src/main/java/cloud/orbit/actors/Addressable.java b/actors/core/src/main/java/cloud/orbit/actors/Addressable.java
@@ -0,0 +1,37 @@
+/*
+ Copyright (C) 2016 Electronic Arts Inc.  All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1.  Redistributions of source code must retain the above copyright
+     notice, this list of conditions and the following disclaimer.
+ 2.  Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimer in the
+     documentation and/or other materials provided with the distribution.
+ 3.  Neither the name of Electronic Arts, Inc. ("EA") nor the names of
+     its contributors may be used to endorse or promote products derived
+     from this software without specific prior written permission.
+
+ THIS SOFTWARE IS PROVIDED BY ELECTRONIC ARTS AND ITS CONTRIBUTORS "AS IS" AND ANY
+ EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL ELECTRONIC ARTS OR ITS CONTRIBUTORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+package cloud.orbit.actors;
+
+/**
+ * Common interface for actor and observer references used internally by the framework.
+ */
+public interface Addressable
+{
+
+}
diff --git a/actors/core/src/main/java/cloud/orbit/actors/ClientObject.java b/actors/core/src/main/java/cloud/orbit/actors/ClientObject.java
@@ -0,0 +1,33 @@
+/*
+ Copyright (C) 2016 Electronic Arts Inc.  All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1.  Redistributions of source code must retain the above copyright
+     notice, this list of conditions and the following disclaimer.
+ 2.  Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimer in the
+     documentation and/or other materials provided with the distribution.
+ 3.  Neither the name of Electronic Arts, Inc. ("EA") nor the names of
+     its contributors may be used to endorse or promote products derived
+     from this software without specific prior written permission.
+
+ THIS SOFTWARE IS PROVIDED BY ELECTRONIC ARTS AND ITS CONTRIBUTORS "AS IS" AND ANY
+ EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL ELECTRONIC ARTS OR ITS CONTRIBUTORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+package cloud.orbit.actors;
+
+public interface ClientObject extends ActorObserver
+{
+}
diff --git a/.../com/ea/orbit/actors/ObserverManager.java → ...a/cloud/orbit/actors/ObserverManager.java b/.../com/ea/orbit/actors/ObserverManager.java → ...a/cloud/orbit/actors/ObserverManager.java
@@ -1,5 +1,5 @@
 /*
- Copyright (C) 2015 Electronic Arts Inc.  All rights reserved.
+ Copyright (C) 2016 Electronic Arts Inc.  All rights reserved.
 
  Redistribution and use in source and binary forms, with or without
  modification, are permitted provided that the following conditions
@@ -26,11 +26,11 @@
  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-package com.ea.orbit.actors;
+package cloud.orbit.actors;
 
-import com.ea.orbit.actors.runtime.RemoteReference;
-import com.ea.orbit.concurrent.ConcurrentHashSet;
-import com.ea.orbit.concurrent.Task;
+import cloud.orbit.actors.runtime.RemoteReference;
+import cloud.orbit.concurrent.ConcurrentHashSet;
+import cloud.orbit.concurrent.Task;
 
 import java.io.Serializable;
 import java.util.ArrayList;

diff --git a/...m/ea/orbit/actors/ObserverMapManager.java → ...loud/orbit/actors/ObserverMapManager.java b/...m/ea/orbit/actors/ObserverMapManager.java → ...loud/orbit/actors/ObserverMapManager.java
@@ -26,10 +26,10 @@
  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-package com.ea.orbit.actors;
+package cloud.orbit.actors;
 
-import com.ea.orbit.actors.runtime.RemoteReference;
-import com.ea.orbit.concurrent.Task;
+import cloud.orbit.actors.runtime.RemoteReference;
+import cloud.orbit.concurrent.Task;
 
 import java.io.Serializable;
 import java.util.ArrayList;

diff --git a/actors/core/src/main/java/cloud/orbit/actors/Remindable.java b/actors/core/src/main/java/cloud/orbit/actors/Remindable.java
@@ -0,0 +1,82 @@
+/*
+ Copyright (C) 2016 Electronic Arts Inc.  All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1.  Redistributions of source code must retain the above copyright
+     notice, this list of conditions and the following disclaimer.
+ 2.  Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimer in the
+     documentation and/or other materials provided with the distribution.
+ 3.  Neither the name of Electronic Arts, Inc. ("EA") nor the names of
+     its contributors may be used to endorse or promote products derived
+     from this software without specific prior written permission.
+
+ THIS SOFTWARE IS PROVIDED BY ELECTRONIC ARTS AND ITS CONTRIBUTORS "AS IS" AND ANY
+ EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED. IN NO EVENT SHALL ELECTRONIC ARTS OR ITS CONTRIBUTORS BE LIABLE FOR ANY
+ DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+package cloud.orbit.actors;
+
+import cloud.orbit.actors.runtime.TickStatus;
+import cloud.orbit.concurrent.Task;
+
+/**
+ * Actors that register reminders must implement the interface Remindable.
+ * <p>
+ * Reminders are a low frequency persisted timers that will be called even if the actor is not currently activated.
+ * </p>
+ * <p><b>Differences between timers and reminders:</b>
+ * <table summary="Differences between timers and reminders">
+ * <thead>
+ * <tr>
+ * <th>Timer</th>
+ * <th>Reminder</th>
+ * </tr>
+ * </thead>
+ * <tbody>
+ * <tr>
+ * <td>Exists only during the activation</td>
+ * <td>Exist until explicitly cancelled by the application</td>
+ * </tr>
+ * <tr>
+ * <td>Can be high frequency, seconds and minutes</td>
+ * <td>Should be low frequency, minutes, hours or days</td>
+ * </tr>
+ * <tr>
+ * <td>Actor deactivation cancels the timer</td>
+ * <td>Reminder remains after deactivation.</td>
+ * </tr>
+ * <tr>
+ * <td>Receive a callback</td>
+ * <td>Call a fixed method</td>
+ * </tr>
+ * <tr>
+ * <td>Any actor can use timers</td>
+ * <td>Only actors whose interface implements IRemindable can use reminders</td>
+ * </tr>
+ * </tbody>
+ * </table></p>
+ *
+ */
+public interface Remindable extends Actor
+{
+    /**
+     * Receive reminder will be called by the reminder subsystem.
+     *
+     * @param reminderName the name of the registered reminder
+     * @param status       the current status of the reminder that triggered this call.
+     * @return an application task that might be completed asynchronously.
+     */
+    Task<?> receiveReminder(String reminderName, TickStatus status);
+}
diff --git a/...rbit/actors/annotation/CacheResponse.java → ...rbit/actors/annotation/CacheResponse.java b/...rbit/actors/annotation/CacheResponse.java → ...rbit/actors/annotation/CacheResponse.java
@@ -26,7 +26,7 @@
  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-package com.ea.orbit.actors.annotation;
+package cloud.orbit.actors.annotation;
 
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;

diff --git a/...m/ea/orbit/actors/annotation/ClassId.java → ...loud/orbit/actors/annotation/ClassId.java b/...m/ea/orbit/actors/annotation/ClassId.java → ...loud/orbit/actors/annotation/ClassId.java
@@ -1,5 +1,5 @@
 /*
- Copyright (C) 2015 Electronic Arts Inc.  All rights reserved.
+ Copyright (C) 2016 Electronic Arts Inc.  All rights reserved.
 
  Redistribution and use in source and binary forms, with or without
  modification, are permitted provided that the following conditions
@@ -26,9 +26,9 @@
  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-package com.ea.orbit.actors.annotation;
+package cloud.orbit.actors.annotation;
 
-import com.ea.orbit.actors.reflection.ExplicitClassIdStrategy;
+import cloud.orbit.actors.reflection.ExplicitClassIdStrategy;
 
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;

diff --git a/...it/actors/annotation/ClassIdStrategy.java → ...it/actors/annotation/ClassIdStrategy.java b/...it/actors/annotation/ClassIdStrategy.java → ...it/actors/annotation/ClassIdStrategy.java
@@ -1,5 +1,5 @@
 /*
- Copyright (C) 2015 Electronic Arts Inc.  All rights reserved.
+ Copyright (C) 2016 Electronic Arts Inc.  All rights reserved.
 
  Redistribution and use in source and binary forms, with or without
  modification, are permitted provided that the following conditions
@@ -26,9 +26,9 @@
  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-package com.ea.orbit.actors.annotation;
+package cloud.orbit.actors.annotation;
 
-import com.ea.orbit.actors.reflection.ClassIdGenerationStrategy;
+import cloud.orbit.actors.reflection.ClassIdGenerationStrategy;
 
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;

diff --git a/...ea/orbit/actors/annotation/Immutable.java → ...ud/orbit/actors/annotation/Immutable.java b/...ea/orbit/actors/annotation/Immutable.java → ...ud/orbit/actors/annotation/Immutable.java
@@ -26,7 +26,7 @@
  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-package com.ea.orbit.actors.annotation;
+package cloud.orbit.actors.annotation;
 
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;

diff --git a/...it/actors/annotation/NeverDeactivate.java → ...it/actors/annotation/NeverDeactivate.java b/...it/actors/annotation/NeverDeactivate.java → ...it/actors/annotation/NeverDeactivate.java
@@ -26,7 +26,7 @@
  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-package com.ea.orbit.actors.annotation;
+package cloud.orbit.actors.annotation;
 
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;

diff --git a/...a/orbit/actors/annotation/NoIdentity.java → ...d/orbit/actors/annotation/NoIdentity.java b/...a/orbit/actors/annotation/NoIdentity.java → ...d/orbit/actors/annotation/NoIdentity.java
@@ -1,5 +1,5 @@
 /*
- Copyright (C) 2015 Electronic Arts Inc.  All rights reserved.
+ Copyright (C) 2016 Electronic Arts Inc.  All rights reserved.
 
  Redistribution and use in source and binary forms, with or without
  modification, are permitted provided that the following conditions
@@ -26,7 +26,7 @@
  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-package com.ea.orbit.actors.annotation;
+package cloud.orbit.actors.annotation;
 
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;