Implement #58

Author: cowtowncoder

release-notes/VERSION

@@ -14,6 +14,7 @@ NOTE: Annotations module will never contain changes in patch versions,
 2.6.0 (not yet released)
 
 #56: Improve `ObjectIdGenerators.key()` to handle `null` appropriately by returning `null`
+#58: Add new properties for `@JsonIgnoreProperties`, "allowGetters", "allowSetters" 
 
 2.5.0 (01-Jan-2015)
 

src/main/java/com/fasterxml/jackson/annotation/JsonCreator.java

@@ -23,13 +23,15 @@
  *   of property to bind to
  *  </li>
  * </ul>
- * Also note that all {@link JsonProperty} annotations MUST use actual name
- * (NOT empty String for "default"): this because Java bytecode does not
- * retain names of method or constructor arguments.
- *<br />
- * NOTE: as of JDK 8, some of above changes, with introduction of names for
- * constructor and method parameters.
- *
+ * Also note that all {@link JsonProperty} annotations must specify actual name
+ * (NOT empty String for "default") unless you use one of extension modules
+ * that can detect parameter name; this because default JDK versions before 8
+ * have not been able to store and/or retrieve parameter names from bytecode.
+ * But with JDK 8 (or using helper libraries such as Paranamer, or other JVM
+ * languages like Scala or Kotlin), specifying name is optional.
+ *<p>
+ * NOTE: As of Jackson 2.6, use of {@link JsonProperty#required()} is supported
+ * for Creator methods (but not necessarily for regular setters or fields!).
  */
 @Target({ElementType.ANNOTATION_TYPE, ElementType.METHOD, ElementType.CONSTRUCTOR})
 @Retention(RetentionPolicy.RUNTIME)

src/main/java/com/fasterxml/jackson/annotation/JsonIgnoreProperties.java

@@ -48,4 +48,30 @@
      * Does not have any effect on serialization.
      */
     public boolean ignoreUnknown() default false;
+
+    /**
+     * Property that can be enabled to allow "getters" to be used (that is,
+     * prevent ignoral of getters for properties listed in {@link #value()}).
+     * This is commonly set to support defining "read-only" properties; ones
+     * for which there is a getter, but no matching setter: in this case,
+     * properties should be ignored for deserialization but NOT serialization.
+     * Default value is `false`, which means that getters with matching names
+     * will be ignored.
+     * 
+     * @since 2.6
+     */
+    public boolean allowGetters() default false;
+
+    /**
+     * Property that can be enabled to allow "setters" to be used (that is,
+     * prevent ignoral of setters for properties listed in {@link #value()}).
+     * This could be used to specify "write-only" properties; ones
+     * that should not be serialized out, but that may be provided in for
+     * deserialization.
+     * Default value is `false`, which means that setters with matching names
+     * will be ignored.
+     * 
+     * @since 2.6
+     */
+    public boolean allowSetters() default false;
 }