Skip to content

Commit 2b13d37

Browse files
sven-olysven-oly
committed
ICU-23056 Add version info for MF2
See #3653
1 parent ff876ca commit 2b13d37

File tree

3 files changed

+191
-0
lines changed

3 files changed

+191
-0
lines changed

‎icu4j/main/core/src/main/java/com/ibm/icu/message2/MFDataModel.java‎

Lines changed: 176 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,17 @@ public interface Message {
4242
*/
4343
@Deprecated
4444
public static class PatternMessage implements Message {
45+
/**
46+
* @internal ICU 72 technology preview
47+
* @deprecated This API is for technology preview only.
48+
*/
49+
@Deprecated
4550
public final List<Declaration> declarations;
51+
/**
52+
* @internal ICU 72 technology preview
53+
* @deprecated This API is for technology preview only.
54+
*/
55+
@Deprecated
4656
public final Pattern pattern;
4757

4858
/**
@@ -62,8 +72,23 @@ public PatternMessage(List<Declaration> declarations, Pattern pattern) {
6272
*/
6373
@Deprecated
6474
public static class SelectMessage implements Message {
75+
/**
76+
* @internal ICU 72 technology preview
77+
* @deprecated This API is for technology preview only.
78+
*/
79+
@Deprecated
6580
public final List<Declaration> declarations;
81+
/**
82+
* @internal ICU 72 technology preview
83+
* @deprecated This API is for technology preview only.
84+
*/
85+
@Deprecated
6686
public final List<Expression> selectors;
87+
/**
88+
* @internal ICU 72 technology preview
89+
* @deprecated This API is for technology preview only.
90+
*/
91+
@Deprecated
6792
public final List<Variant> variants;
6893

6994
/**
@@ -96,7 +121,17 @@ public interface Declaration {
96121
*/
97122
@Deprecated
98123
public static class InputDeclaration implements Declaration {
124+
/**
125+
* @internal ICU 72 technology preview
126+
* @deprecated This API is for technology preview only.
127+
*/
128+
@Deprecated
99129
public final String name;
130+
/**
131+
* @internal ICU 72 technology preview
132+
* @deprecated This API is for technology preview only.
133+
*/
134+
@Deprecated
100135
public final VariableExpression value;
101136

102137
/**
@@ -116,7 +151,17 @@ public InputDeclaration(String name, VariableExpression value) {
116151
*/
117152
@Deprecated
118153
public static class LocalDeclaration implements Declaration {
154+
/**
155+
* @internal ICU 72 technology preview
156+
* @deprecated This API is for technology preview only.
157+
*/
158+
@Deprecated
119159
public final String name;
160+
/**
161+
* @internal ICU 72 technology preview
162+
* @deprecated This API is for technology preview only.
163+
*/
164+
@Deprecated
120165
public final Expression value;
121166

122167
/**
@@ -145,7 +190,17 @@ public interface LiteralOrCatchallKey {
145190
*/
146191
@Deprecated
147192
public static class Variant implements LiteralOrCatchallKey {
193+
/**
194+
* @internal ICU 72 technology preview
195+
* @deprecated This API is for technology preview only.
196+
*/
197+
@Deprecated
148198
public final List<LiteralOrCatchallKey> keys;
199+
/**
200+
* @internal ICU 72 technology preview
201+
* @deprecated This API is for technology preview only.
202+
*/
203+
@Deprecated
149204
public final Pattern value;
150205

151206
/**
@@ -168,9 +223,20 @@ public static class CatchallKey implements LiteralOrCatchallKey {
168223
final static String AS_KEY_STRING = "<<::CatchallKey::>>";
169224
// String value; // Always '*' in MF2
170225

226+
/**
227+
* @internal ICU 72 technology preview
228+
* @deprecated This API is for technology preview only.
229+
*/
230+
@Deprecated
171231
public static boolean isCatchAll(String key) {
172232
return AS_KEY_STRING.equals(key);
173233
}
234+
/**
235+
* @internal ICU 72 technology preview
236+
* @deprecated This API is for technology preview only.
237+
*/
238+
@Deprecated
239+
public CatchallKey() {}
174240
}
175241

176242
// Patterns
@@ -182,6 +248,11 @@ public static boolean isCatchAll(String key) {
182248
*/
183249
@Deprecated
184250
public static class Pattern {
251+
/**
252+
* @internal ICU 72 technology preview
253+
* @deprecated This API is for technology preview only.
254+
*/
255+
@Deprecated
185256
public final List<PatternPart> parts;
186257

187258
Pattern() {
@@ -204,6 +275,11 @@ public interface PatternPart {
204275
*/
205276
@Deprecated
206277
public static class StringPart implements PatternPart {
278+
/**
279+
* @internal ICU 72 technology preview
280+
* @deprecated This API is for technology preview only.
281+
*/
282+
@Deprecated
207283
public final String value;
208284

209285
StringPart(String value) {
@@ -227,8 +303,23 @@ public interface Expression extends PatternPart {
227303
*/
228304
@Deprecated
229305
public static class LiteralExpression implements Expression {
306+
/**
307+
* @internal ICU 72 technology preview
308+
* @deprecated This API is for technology preview only.
309+
*/
310+
@Deprecated
230311
public final Literal arg;
312+
/**
313+
* @internal ICU 72 technology preview
314+
* @deprecated This API is for technology preview only.
315+
*/
316+
@Deprecated
231317
public final FunctionRef function;
318+
/**
319+
* @internal ICU 72 technology preview
320+
* @deprecated This API is for technology preview only.
321+
*/
322+
@Deprecated
232323
public final List<Attribute> attributes;
233324

234325
/**
@@ -249,8 +340,23 @@ public LiteralExpression(Literal arg, FunctionRef function, List<Attribute> attr
249340
*/
250341
@Deprecated
251342
public static class VariableExpression implements Expression {
343+
/**
344+
* @internal ICU 72 technology preview
345+
* @deprecated This API is for technology preview only.
346+
*/
347+
@Deprecated
252348
public final VariableRef arg;
349+
/**
350+
* @internal ICU 72 technology preview
351+
* @deprecated This API is for technology preview only.
352+
*/
353+
@Deprecated
253354
public final FunctionRef function;
355+
/**
356+
* @internal ICU 72 technology preview
357+
* @deprecated This API is for technology preview only.
358+
*/
359+
@Deprecated
254360
public final List<Attribute> attributes;
255361

256362
/**
@@ -272,7 +378,17 @@ public VariableExpression(
272378
*/
273379
@Deprecated
274380
public static class FunctionRef {
381+
/**
382+
* @internal ICU 72 technology preview
383+
* @deprecated This API is for technology preview only.
384+
*/
385+
@Deprecated
275386
public final String name;
387+
/**
388+
* @internal ICU 72 technology preview
389+
* @deprecated This API is for technology preview only.
390+
*/
391+
@Deprecated
276392
public final Map<String, Option> options;
277393

278394
/**
@@ -292,7 +408,17 @@ public FunctionRef(String name, Map<String, Option> options) {
292408
*/
293409
@Deprecated
294410
public static class FunctionExpression implements Expression {
411+
/**
412+
* @internal ICU 72 technology preview
413+
* @deprecated This API is for technology preview only.
414+
*/
415+
@Deprecated
295416
public final FunctionRef function;
417+
/**
418+
* @internal ICU 72 technology preview
419+
* @deprecated This API is for technology preview only.
420+
*/
421+
@Deprecated
296422
public final List<Attribute> attributes;
297423

298424
/**
@@ -312,7 +438,17 @@ public FunctionExpression(FunctionRef function, List<Attribute> attributes) {
312438
*/
313439
@Deprecated
314440
public static class Attribute {
441+
/**
442+
* @internal ICU 72 technology preview
443+
* @deprecated This API is for technology preview only.
444+
*/
445+
@Deprecated
315446
public final String name;
447+
/**
448+
* @internal ICU 72 technology preview
449+
* @deprecated This API is for technology preview only.
450+
*/
451+
@Deprecated
316452
public final LiteralOrVariableRef value;
317453

318454
/**
@@ -345,6 +481,11 @@ public interface LiteralOrVariableRef {
345481
*/
346482
@Deprecated
347483
public static class Literal implements LiteralOrVariableRef, LiteralOrCatchallKey {
484+
/**
485+
* @internal ICU 72 technology preview
486+
* @deprecated This API is for technology preview only.
487+
*/
488+
@Deprecated
348489
public final String value;
349490

350491
/**
@@ -363,6 +504,11 @@ public Literal(String value) {
363504
*/
364505
@Deprecated
365506
public static class VariableRef implements LiteralOrVariableRef {
507+
/**
508+
* @internal ICU 72 technology preview
509+
* @deprecated This API is for technology preview only.
510+
*/
511+
@Deprecated
366512
public final String name;
367513

368514
/**
@@ -381,7 +527,17 @@ public VariableRef(String name) {
381527
*/
382528
@Deprecated
383529
public static class Option {
530+
/**
531+
* @internal ICU 72 technology preview
532+
* @deprecated This API is for technology preview only.
533+
*/
534+
@Deprecated
384535
public final String name;
536+
/**
537+
* @internal ICU 72 technology preview
538+
* @deprecated This API is for technology preview only.
539+
*/
540+
@Deprecated
385541
public final LiteralOrVariableRef value;
386542

387543
/**
@@ -409,9 +565,29 @@ enum Kind {
409565
STANDALONE
410566
}
411567

568+
/**
569+
* @internal ICU 72 technology preview
570+
* @deprecated This API is for technology preview only.
571+
*/
572+
@Deprecated
412573
public final Kind kind;
574+
/**
575+
* @internal ICU 72 technology preview
576+
* @deprecated This API is for technology preview only.
577+
*/
578+
@Deprecated
413579
public final String name;
580+
/**
581+
* @internal ICU 72 technology preview
582+
* @deprecated This API is for technology preview only.
583+
*/
584+
@Deprecated
414585
public final Map<String, Option> options;
586+
/**
587+
* @internal ICU 72 technology preview
588+
* @deprecated This API is for technology preview only.
589+
*/
590+
@Deprecated
415591
public final List<Attribute> attributes;
416592

417593
/**

‎icu4j/main/core/src/main/java/com/ibm/icu/message2/MFParseException.java‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,12 +20,20 @@ public class MFParseException extends ParseException {
2020
*
2121
* @param message the message
2222
* @param errorOffset the position where the error is found while parsing.
23+
* @internal ICU 75 technology preview
24+
* @deprecated This API is for technology preview only.
2325
*/
26+
@Deprecated
2427
public MFParseException(String message, int errorOffset) {
2528
super(message, errorOffset);
2629
}
2730

31+
/**
32+
* @internal ICU 75 technology preview
33+
* @deprecated This API is for technology preview only.
34+
*/
2835
@Override
36+
@Deprecated
2937
public String getMessage() {
3038
return super.getMessage();
3139
}

‎icu4j/main/core/src/main/java/com/ibm/icu/message2/MFSerializer.java‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,13 @@ public class MFSerializer {
4343
private boolean needSpace = false;
4444
private final StringBuilder result = new StringBuilder();
4545

46+
/**
47+
* @internal ICU 75 technology preview
48+
* @deprecated This API is for technology preview only.
49+
*/
50+
@Deprecated
51+
public MFSerializer() {}
52+
4653
/**
4754
* Method converting the {@link MFDataModel.Message} to a string in MessageFormat 2 syntax.
4855
*

0 commit comments

Comments
 (0)