回滚Annotation

Author: syswu

src/main/java/io/github/kubesys/client/annotations/Api.java

@@ -0,0 +1,45 @@
+/**
+ * Copyright (2023, ) Institute of Software, Chinese Academy of Sciences
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.github.kubesys.client.annotations;
+
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author  wuheng@iscas.ac.cn
+ * @since   2023/07/25
+ * @version 1.0.0
+ *
+ */
+@Target({ElementType.METHOD, ElementType.CONSTRUCTOR}) 
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+public @interface Api {
+
+	/**
+	 * @return api description
+	 */
+	String desc() default "";
+	
+	/**
+	 * @return all exceptions
+	 */
+	Class<?>[] catches() default {};
+}

src/main/java/io/github/kubesys/client/annotations/Catch.java

@@ -0,0 +1,45 @@
+/**
+ * Copyright (2023, ) Institute of Software, Chinese Academy of Sciences
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.github.kubesys.client.annotations;
+
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author  wuheng@iscas.ac.cn
+ * @since   2023/07/25
+ * @version 1.0.0
+ *
+ */
+@Target({ElementType.METHOD, ElementType.TYPE}) 
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+public @interface Catch {
+
+	/**
+	 * @return code, see io.github.kubesys.client.exceptions
+	 */
+	int code() default -1;
+	
+	/**
+	 * @return description for a given exception
+	 */
+	String desc() default "";
+}

src/main/java/io/github/kubesys/client/annotations/Env.java

@@ -0,0 +1,50 @@
+/**
+ * Copyright (2023, ) Institute of Software, Chinese Academy of Sciences
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.github.kubesys.client.annotations;
+
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author  wuheng@iscas.ac.cn
+ * @since   2023/07/25
+ * @version 1.0.0
+ *
+ */
+@Target({ElementType.FIELD}) 
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+public @interface Env {
+
+	/**
+	 * @return description
+	 */
+	String desc() default "";
+	
+	/**
+	 * @return example
+	 */
+	String example() default "";
+	
+	/**
+	 * @return value
+	 */
+	String defaultValue() default "";
+}

src/main/java/io/github/kubesys/client/annotations/Param.java

@@ -0,0 +1,46 @@
+/**
+ * Copyright (2023, ) Institute of Software, Chinese Academy of Sciences
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package io.github.kubesys.client.annotations;
+
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * @author  wuheng@iscas.ac.cn
+ * @since   2023/07/25
+ * @version 1.0.0
+ *
+ */
+@Target({ElementType.PARAMETER}) 
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+public @interface Param {
+
+	/**
+	 * @return description
+	 */
+	String desc() default "";
+	
+	/**
+	 * @return regexp
+	 */
+	String regexp() default "";
+	
+}