blob: e607da9e97e357e87cebea830357eff4dd80b992 [file] [log] [blame]
Tatu Saloranta7580af02013-04-22 19:54:26 -07001Project: jackson-annotations
Tatu Saloranta39a4a282012-02-24 16:00:54 -08002
Tatu Saloranta35126792014-03-27 19:57:02 -07003NOTE: Annotations module will never contain changes in patch versions,
Tatu Saloranta94e157f2014-05-29 09:44:56 -07004 only .0 releases can have changes. We may still release patch versions, but
5 they will be identical to .0 versions, and only released for convenience
Tatu Saloranta116a96e2014-11-06 08:26:17 -08006 (developers can line up all Jackson components with same patch version number).
7 Main components will typically depend on .0 versions: please do NOT file
8 issues against this being a bug; it is intentional.
Tatu75f446b2014-01-02 12:31:37 -08009
Tatu Saloranta90f9db82014-06-15 15:13:19 -070010------------------------------------------------------------------------
Tatu Saloranta3e08b402014-10-16 22:49:33 -070011=== Releases ===
Tatu Saloranta90f9db82014-06-15 15:13:19 -070012------------------------------------------------------------------------
13
Cowtowncoder5261db02015-04-02 11:40:27 -0700142.6.0 (not yet released)
15
Cowtowncodere4bde872015-06-18 14:36:20 -070016#43: Add `@JsonFormat(with=Feature.xxx)` to support things like
17 `DeserializationFeature.ACCEEPT_SINGLE_VALUE_AS_ARRAY`.
Cowtowncoder5261db02015-04-02 11:40:27 -070018#56: Improve `ObjectIdGenerators.key()` to handle `null` appropriately by returning `null`
Tatu Salorantac04af7f2015-05-13 22:27:50 -070019#58: Add new properties for `@JsonIgnoreProperties`, "allowGetters", "allowSetters"
Tatu Salorantab8b740d2015-06-01 21:25:24 -070020#60: Add new value type, `OptBoolean`, for "optional booleans", to support proper handling
Tatu Saloranta85f5f0c2015-05-31 11:44:07 -070021 and usage of default values, not just explicit true/false.
Tatu Saloranta8e929c22015-06-01 21:26:57 -070022#61: dd new property, `@JsonProperty.access` (and matching enum) to support read-only/write-only properties
Cowtowncoder45959362015-05-28 16:52:48 -070023- Add `JsonInclude.Include.NON_ABSENT` value, for excluding "absent" Optional values.
Cowtowncoder8169e3f2015-06-23 14:49:47 -070024- Add tag interface `JacksonAnnotationValue` for helper types used for encapsuating information
25 for "complex" annotations (multi-property ones)
Cowtowncoder5261db02015-04-02 11:40:27 -070026
Tatu Salorantafbacc432015-01-01 15:30:33 -0800272.5.0 (01-Jan-2015)
Tatu Saloranta3e08b402014-10-16 22:49:33 -070028
Tatu Saloranta17a1e4a2014-12-20 10:59:48 -080029#47: Add `@JsonCreator.mode` property to explicitly choose between delegating-
30 and property-based creators, or to disable specific creator (Mode.DISABLED)
Cowtowncoder3cb23562014-12-04 13:20:26 -080031#48: Allow `@JsonView` for (method) parameters too
Tatu Salorantaede5f8d2014-12-06 15:26:03 -080032#49: Add `@JsonTypeInfo.skipWritingDefault`
Tatu Saloranta469b4742014-12-09 21:00:23 -080033#50: Add `ObjectIdGenerator.maySerializeAsObject()`,
34 `ObjectIdGenerator.ObjectIdGenerator.maySerializeAsObject()` to support JSOG
Tatu Saloranta3e08b402014-10-16 22:49:33 -070035- Added `@JsonInclude.content` to allow specifying inclusion criteria
36 for `java.util.Map` entries separate from inclusion of `Map` values
37 themselves
Cowtowncoder7a409472014-12-19 13:14:58 -080038- Finalize fix for [databind#490], by ensuring new mapping initialized for new context
Cowtowncoder4e78c6b2014-12-23 17:27:50 -080039- Added `@JsonProperty.defaultValue()` (related to [databind#596])
Tatu Saloranta3e08b402014-10-16 22:49:33 -070040
Tatu Salorantafe4139c2014-11-24 18:01:06 -0800412.4.4 (24-Nov-2014)
Tatu Saloranta116a96e2014-11-06 08:26:17 -0800422.4.3 (02-Oct-2014)
Tatu Salorantaf6675b02014-10-02 18:57:02 -0700432.4.2 (13-Aug-2014)
442.4.1
45
46No changes since 2.4.0.
47
Tatu Saloranta90f9db82014-06-15 15:13:19 -0700482.4.0 (29-May-2014)
49
Tatu Salorantad7e541c2014-03-14 21:21:02 -070050#31: Allow use of `@JsonPropertyOrder` for properties (not just classes)
Tatu Salorantad9f31b72014-04-09 19:23:11 -070051#32: Add `@JsonProperty.index`
Tatu Salorantab61db142014-03-27 20:36:01 -070052- Add `JsonFormat.Value#timeZoneAsString` (needed by Joda module)
Tatu Salorantadf34a312014-05-07 18:25:04 -070053- Add `@JsonRootName.namespace` to allow specifying of namespace with
54 standard Jackson annotations (not just XML-specific ones that dataformat-xml
55 provides)
Tatu Salorantad7e541c2014-03-14 21:21:02 -070056
Tatu Saloranta94e157f2014-05-29 09:44:56 -0700572.3.2 (01-Mar-2014)
Tatu Saloranta35126792014-03-27 19:57:02 -0700582.3.1 (28-Dec-2013)
Tatu75f446b2014-01-02 12:31:37 -0800592.3.0 (13-Nov-2013)
Tatu Salorantaa8ca29b2012-11-12 14:30:14 -080060
Tatu Salorantad8d2e812013-07-25 18:48:07 -070061#13: Add `@JsonPropertyDescription`
62 (suggested by Net-A-Porter@github)
Tatu Saloranta18c5e262013-09-12 18:14:05 -070063#20: Allow use of `@JsonFilter` for properties (via fields, methods,
64 constructor parameters)
Tatud003e822013-10-25 10:29:08 -070065(note: although #15 -- Add `JsonTypeInfo.As.EXISTING` property to support new
66 variation for including Type Id was included, jackson-databind does not
67 yet support it as of 2.3.0)
Tatu Salorantaa431ceb2013-07-24 22:45:05 -070068
Tatu75f446b2014-01-02 12:31:37 -0800692.2.3 (23-Aug-2013)
Tatu Salorantad713c9f2013-06-06 14:01:02 -0700702.2.2 (26-May-2013)
71
Tatu Saloranta35126792014-03-27 19:57:02 -070072No changes since 2.2.1
Tatu Salorantad713c9f2013-06-06 14:01:02 -070073
Tatu Saloranta29299cf2013-05-26 21:26:21 -0700742.2.1 (03-May-2013)
75
76- Moved LICENSE file under 'META-INF/' in jar
77
Tatu Saloranta49870312013-04-26 16:43:55 -0700782.2.0 (22-Apr-2013)
79
Tatu Saloranta35126792014-03-27 19:57:02 -070080No changes since 2.1.1
Tatu Saloranta49870312013-04-26 16:43:55 -070081
Tatu Salorantaa8ca29b2012-11-12 14:30:14 -0800822.1.1 (11-Nov-2012)
Tatu Saloranta4b6fd6a2012-11-11 15:36:08 -080083
84Fixes:
85
86* Make ObjectIdGenerator java.io.Serializable (needed when serializing
87 ObjectMappers/-Writers/-Readers)
88
Tatu Saloranta4b6fd6a2012-11-11 15:36:08 -0800892.1.0 (08-Oct-2012)
Tatu Saloranta1e2b4042012-05-14 19:42:57 -070090
Tatu Salorantaccbc0862012-08-24 12:42:04 -070091New features:
92
93* [Issue#4]: Add '@JsonIdentityReference', to support use case where values of
94 a specific reference property are always serialized as ids, never as full POJO
Tatu Saloranta1e2b4042012-05-14 19:42:57 -070095
Tatu Saloranta0ba14012012-10-04 17:36:10 -070096Improvements:
97
98* Added '@JsonIdentityInfo.firstAsID' property, to allow forcing all references
99 to an Object to be serialized as id, including first one.
100* Fix OSGi artifact name to be fully-qualified
101
Tatu Saloranta1e2b4042012-05-14 19:42:57 -0700102
1032.0.2 (14-May-2012)
Tatu Saloranta52654bd2012-04-22 10:35:46 -0700104
Tatu Saloranta227498d2012-05-14 18:40:12 -0700105Fixes:
106
107* OSGi bundle name was accidentally changed in 2.0.1; reverted back to one
108 used in 2.0.0, earlier
Tatu Saloranta52654bd2012-04-22 10:35:46 -0700109 (reported Pascal G)
110
Tatu Saloranta227498d2012-05-14 18:40:12 -07001112.0.1 (22-Apr-2012)
112
113Fixes:
114
115* [JACKSON-827] Fix incompatibilities with JDK 1.5 (2.0.0 accidentally
116 required 1.6)
117 (reported Pascal G)
118
Tatu Saloranta52654bd2012-04-22 10:35:46 -07001192.0.0 (25-Mar-2012)
Tatu Salorantaf7404ed2012-03-25 11:41:23 -0700120
121Improvements:
122
123* [JACKSON-437]: Allow injecting of type id as POJO property, by setting
124 new '@JsonTypeInfo.visible' property to true.
125* [JACKSON-669]: Allow prefix/suffix for @JsonUnwrapped properties
126 (requested by Aner P)
127* [JACKSON-787]: @JsonIgnoredProperties can be used on properties too
Tatu Saloranta39a4a282012-02-24 16:00:54 -0800128
129New features:
130
Tatu Salorantaf7404ed2012-03-25 11:41:23 -0700131* [JACKSON-107]: Add support for Object Identity (to handled cycles, shared refs),
132 with @JsonIdentityInfo
Tatu Saloranta39a4a282012-02-24 16:00:54 -0800133* [JACKSON-714] Add general-purpose '@JsonFormat' annotation
Tatu Salorantaf7404ed2012-03-25 11:41:23 -0700134* [JACKSON-752]: Add @JsonInclude (replacement of @JsonSerialize.include)
135* [JACKSON-754]: Add @JacksonAnnotationsInside for creating "annotation
136 bundles" (also: AnnotationIntrospector.isAnnotationBundle())
137
138Other:
139
140* Lots of miscellaneous refactoring; moving most annotations from
141 databind into this package; only leaving ones that depend on
142 databind package types
Tatu Saloranta39a4a282012-02-24 16:00:54 -0800143
144------------------------------------------------------------------------
145=== History: ===
146------------------------------------------------------------------------
147
148[entries for versions 1.x and earlier not retained; refer to earlier releases)