Author: pmouawad
Date: Sun Feb 24 14:14:09 2019
New Revision: 1854261
URL: http://svn.apache.org/viewvc?rev=1854261&view=rev
Log:
Bug 63203 - Unit Tests : Replace use of @Deprecated by @VisibleForTesting for
methods/constructors/classes made public for Unit Testing only
Bugzilla Id: 63203
Added:
jmeter/trunk/src/jorphan/org/apache/jorphan/documentation/
jmeter/trunk/src/jorphan/org/apache/jorphan/documentation/VisibleForTesting.java
(with props)
Modified:
jmeter/trunk/xdocs/changes.xml
Added:
jmeter/trunk/src/jorphan/org/apache/jorphan/documentation/VisibleForTesting.java
URL:
http://svn.apache.org/viewvc/jmeter/trunk/src/jorphan/org/apache/jorphan/documentation/VisibleForTesting.java?rev=1854261&view=auto
==============================================================================
---
jmeter/trunk/src/jorphan/org/apache/jorphan/documentation/VisibleForTesting.java
(added)
+++
jmeter/trunk/src/jorphan/org/apache/jorphan/documentation/VisibleForTesting.java
Sun Feb 24 14:14:09 2019
@@ -0,0 +1,58 @@
+ /*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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 org.apache.jorphan.documentation;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+
+/**
+ * Denotes that the class, method or field has its visibility relaxed so
+ * that unit tests can access it.
+ * This means that this API is not-public.
+ * <p/>
+ * The <code>visibility</code> argument can be used to specific what the
original
+ * visibility should have been if it had not been made public or
package-private for testing.
+ * The default is to consider the element private.
+ *
+ * Copy of this class under ASL license:
+ *
https://github.com/aosp-mirror/platform_frameworks_base/blob/8b2c3a14603d163d7564e6f60286995079687690/core/java/com/android/internal/annotations/VisibleForTesting.java
+ */
+@Documented
+@Retention(RetentionPolicy.SOURCE)
+public @interface VisibleForTesting {
+ /**
+ * Intended visibility if the element had not been made public or
package-private for
+ * testing.
+ */
+ enum Visibility {
+ /** The element should be considered protected. */
+ PROTECTED,
+ /** The element should be considered package-private. */
+ PACKAGE,
+ /** The element should be considered private. */
+ PRIVATE
+ }
+
+ /**
+ * Intended visibility if the element had not been made public or
package-private for testing.
+ * If not specified, one should assume the element originally intended to
be private.
+ */
+ Visibility visibility() default Visibility.PRIVATE;
+}
Propchange:
jmeter/trunk/src/jorphan/org/apache/jorphan/documentation/VisibleForTesting.java
------------------------------------------------------------------------------
svn:eol-style = native
Propchange:
jmeter/trunk/src/jorphan/org/apache/jorphan/documentation/VisibleForTesting.java
------------------------------------------------------------------------------
svn:mime-type = text/plain
Modified: jmeter/trunk/xdocs/changes.xml
URL:
http://svn.apache.org/viewvc/jmeter/trunk/xdocs/changes.xml?rev=1854261&r1=1854260&r2=1854261&view=diff
==============================================================================
--- jmeter/trunk/xdocs/changes.xml [utf-8] (original)
+++ jmeter/trunk/xdocs/changes.xml [utf-8] Sun Feb 24 14:14:09 2019
@@ -114,6 +114,7 @@ Summary
<ch_section>Non-functional changes</ch_section>
<ul>
+ <li>Bug 63203 - Unit Tests : Replace use of <code>@Deprecated</code> by
<code>@VisibleForTesting</code> for methods/constructors/classes made public
for Unit Testing only</li>
</ul>
<!-- =================== Bug fixes =================== -->
