blob: 8c365c243b5db1696a1655e428900bc4571f9bc2 [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.
Cowtowncoder5261db02015-04-02 11:40:27 -070024
Tatu Salorantafbacc432015-01-01 15:30:33 -0800252.5.0 (01-Jan-2015)
Tatu Saloranta3e08b402014-10-16 22:49:33 -070026
Tatu Saloranta17a1e4a2014-12-20 10:59:48 -080027#47: Add `@JsonCreator.mode` property to explicitly choose between delegating-
28 and property-based creators, or to disable specific creator (Mode.DISABLED)
Cowtowncoder3cb23562014-12-04 13:20:26 -080029#48: Allow `@JsonView` for (method) parameters too
Tatu Salorantaede5f8d2014-12-06 15:26:03 -080030#49: Add `@JsonTypeInfo.skipWritingDefault`
Tatu Saloranta469b4742014-12-09 21:00:23 -080031#50: Add `ObjectIdGenerator.maySerializeAsObject()`,
32 `ObjectIdGenerator.ObjectIdGenerator.maySerializeAsObject()` to support JSOG
Tatu Saloranta3e08b402014-10-16 22:49:33 -070033- Added `@JsonInclude.content` to allow specifying inclusion criteria
34 for `java.util.Map` entries separate from inclusion of `Map` values
35 themselves
Cowtowncoder7a409472014-12-19 13:14:58 -080036- Finalize fix for [databind#490], by ensuring new mapping initialized for new context
Cowtowncoder4e78c6b2014-12-23 17:27:50 -080037- Added `@JsonProperty.defaultValue()` (related to [databind#596])
Tatu Saloranta3e08b402014-10-16 22:49:33 -070038
Tatu Salorantafe4139c2014-11-24 18:01:06 -0800392.4.4 (24-Nov-2014)
Tatu Saloranta116a96e2014-11-06 08:26:17 -0800402.4.3 (02-Oct-2014)
Tatu Salorantaf6675b02014-10-02 18:57:02 -0700412.4.2 (13-Aug-2014)
422.4.1
43
44No changes since 2.4.0.
45
Tatu Saloranta90f9db82014-06-15 15:13:19 -0700462.4.0 (29-May-2014)
47
Tatu Salorantad7e541c2014-03-14 21:21:02 -070048#31: Allow use of `@JsonPropertyOrder` for properties (not just classes)
Tatu Salorantad9f31b72014-04-09 19:23:11 -070049#32: Add `@JsonProperty.index`
Tatu Salorantab61db142014-03-27 20:36:01 -070050- Add `JsonFormat.Value#timeZoneAsString` (needed by Joda module)
Tatu Salorantadf34a312014-05-07 18:25:04 -070051- Add `@JsonRootName.namespace` to allow specifying of namespace with
52 standard Jackson annotations (not just XML-specific ones that dataformat-xml
53 provides)
Tatu Salorantad7e541c2014-03-14 21:21:02 -070054
Tatu Saloranta94e157f2014-05-29 09:44:56 -0700552.3.2 (01-Mar-2014)
Tatu Saloranta35126792014-03-27 19:57:02 -0700562.3.1 (28-Dec-2013)
Tatu75f446b2014-01-02 12:31:37 -0800572.3.0 (13-Nov-2013)
Tatu Salorantaa8ca29b2012-11-12 14:30:14 -080058
Tatu Salorantad8d2e812013-07-25 18:48:07 -070059#13: Add `@JsonPropertyDescription`
60 (suggested by Net-A-Porter@github)
Tatu Saloranta18c5e262013-09-12 18:14:05 -070061#20: Allow use of `@JsonFilter` for properties (via fields, methods,
62 constructor parameters)
Tatud003e822013-10-25 10:29:08 -070063(note: although #15 -- Add `JsonTypeInfo.As.EXISTING` property to support new
64 variation for including Type Id was included, jackson-databind does not
65 yet support it as of 2.3.0)
Tatu Salorantaa431ceb2013-07-24 22:45:05 -070066
Tatu75f446b2014-01-02 12:31:37 -0800672.2.3 (23-Aug-2013)
Tatu Salorantad713c9f2013-06-06 14:01:02 -0700682.2.2 (26-May-2013)
69
Tatu Saloranta35126792014-03-27 19:57:02 -070070No changes since 2.2.1
Tatu Salorantad713c9f2013-06-06 14:01:02 -070071
Tatu Saloranta29299cf2013-05-26 21:26:21 -0700722.2.1 (03-May-2013)
73
74- Moved LICENSE file under 'META-INF/' in jar
75
Tatu Saloranta49870312013-04-26 16:43:55 -0700762.2.0 (22-Apr-2013)
77
Tatu Saloranta35126792014-03-27 19:57:02 -070078No changes since 2.1.1
Tatu Saloranta49870312013-04-26 16:43:55 -070079
Tatu Salorantaa8ca29b2012-11-12 14:30:14 -0800802.1.1 (11-Nov-2012)
Tatu Saloranta4b6fd6a2012-11-11 15:36:08 -080081
82Fixes:
83
84* Make ObjectIdGenerator java.io.Serializable (needed when serializing
85 ObjectMappers/-Writers/-Readers)
86
Tatu Saloranta4b6fd6a2012-11-11 15:36:08 -0800872.1.0 (08-Oct-2012)
Tatu Saloranta1e2b4042012-05-14 19:42:57 -070088
Tatu Salorantaccbc0862012-08-24 12:42:04 -070089New features:
90
91* [Issue#4]: Add '@JsonIdentityReference', to support use case where values of
92 a specific reference property are always serialized as ids, never as full POJO
Tatu Saloranta1e2b4042012-05-14 19:42:57 -070093
Tatu Saloranta0ba14012012-10-04 17:36:10 -070094Improvements:
95
96* Added '@JsonIdentityInfo.firstAsID' property, to allow forcing all references
97 to an Object to be serialized as id, including first one.
98* Fix OSGi artifact name to be fully-qualified
99
Tatu Saloranta1e2b4042012-05-14 19:42:57 -0700100
1012.0.2 (14-May-2012)
Tatu Saloranta52654bd2012-04-22 10:35:46 -0700102
Tatu Saloranta227498d2012-05-14 18:40:12 -0700103Fixes:
104
105* OSGi bundle name was accidentally changed in 2.0.1; reverted back to one
106 used in 2.0.0, earlier
Tatu Saloranta52654bd2012-04-22 10:35:46 -0700107 (reported Pascal G)
108
Tatu Saloranta227498d2012-05-14 18:40:12 -07001092.0.1 (22-Apr-2012)
110
111Fixes:
112
113* [JACKSON-827] Fix incompatibilities with JDK 1.5 (2.0.0 accidentally
114 required 1.6)
115 (reported Pascal G)
116
Tatu Saloranta52654bd2012-04-22 10:35:46 -07001172.0.0 (25-Mar-2012)
Tatu Salorantaf7404ed2012-03-25 11:41:23 -0700118
119Improvements:
120
121* [JACKSON-437]: Allow injecting of type id as POJO property, by setting
122 new '@JsonTypeInfo.visible' property to true.
123* [JACKSON-669]: Allow prefix/suffix for @JsonUnwrapped properties
124 (requested by Aner P)
125* [JACKSON-787]: @JsonIgnoredProperties can be used on properties too
Tatu Saloranta39a4a282012-02-24 16:00:54 -0800126
127New features:
128
Tatu Salorantaf7404ed2012-03-25 11:41:23 -0700129* [JACKSON-107]: Add support for Object Identity (to handled cycles, shared refs),
130 with @JsonIdentityInfo
Tatu Saloranta39a4a282012-02-24 16:00:54 -0800131* [JACKSON-714] Add general-purpose '@JsonFormat' annotation
Tatu Salorantaf7404ed2012-03-25 11:41:23 -0700132* [JACKSON-752]: Add @JsonInclude (replacement of @JsonSerialize.include)
133* [JACKSON-754]: Add @JacksonAnnotationsInside for creating "annotation
134 bundles" (also: AnnotationIntrospector.isAnnotationBundle())
135
136Other:
137
138* Lots of miscellaneous refactoring; moving most annotations from
139 databind into this package; only leaving ones that depend on
140 databind package types
Tatu Saloranta39a4a282012-02-24 16:00:54 -0800141
142------------------------------------------------------------------------
143=== History: ===
144------------------------------------------------------------------------
145
146[entries for versions 1.x and earlier not retained; refer to earlier releases)