diff options
author | Ilia Motornyi <elmot@vaadin.com> | 2018-07-11 09:25:51 +0300 |
---|---|---|
committer | Teemu Suo-Anttila <tsuoanttila@users.noreply.github.com> | 2018-07-11 09:25:51 +0300 |
commit | b7ac760a0c26d0edc7aa532281a9085766a99a3f (patch) | |
tree | 14f1448b5a579b7318a899bd344f4e381fae0e76 /documentation/components | |
parent | 7f06076dc4bd4cbdc5a2cc6cde00adb6dec1de2e (diff) | |
download | vaadin-framework-b7ac760a0c26d0edc7aa532281a9085766a99a3f.tar.gz vaadin-framework-b7ac760a0c26d0edc7aa532281a9085766a99a3f.zip |
Add reminder of serialization to Grid documentation (#11037)
Diffstat (limited to 'documentation/components')
-rw-r--r-- | documentation/components/components-grid.asciidoc | 21 |
1 files changed, 11 insertions, 10 deletions
diff --git a/documentation/components/components-grid.asciidoc b/documentation/components/components-grid.asciidoc index e1e3e716e4..3994ae907c 100644 --- a/documentation/components/components-grid.asciidoc +++ b/documentation/components/components-grid.asciidoc @@ -533,18 +533,19 @@ Formats a column with the [classname]#LocalDate# type. The renderer can be constructed with a [classname]#DateTimeFormatter#, or with a custom pattern string. The locale is either given explicitly with the pattern, resolved from the given [classname]#DateTimeFormatter# or from the grid the renderer is attached to, if neither of the previous are given. For the pattern string syntax, refer to the following documentation: link:https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html#patterns[docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html#patterns]. - +Note we should use `SerializableProvider<DateTimeFormatter>` or lambda in the first case, because +`DateTimeFormatter` is not serializable, and that may lead to problems in certain cases, for instance in a cluster environment. + [source, java] ---- -DateTimeFormatter formatter = DateTimeFormatter +LocalDateRenderer renderer = new LocalDateRenderer(() -> DateTimeFormatter .ofLocalizedDate(FormatStyle.LONG) - .withLocale(Locale.ENGLISH); + .withLocale(Locale.ENGLISH)); Column<Person, LocalDate> bornColumn = grid.addColumn( Person::getBirthDate, - new LocalDateRenderer(formatter)); + renderer); // Alternatively, with a custom pattern: Column<Person, LocalDate> bornColumn = @@ -559,14 +560,14 @@ Otherwise the same as [classname]#LocalDateRenderer#, except for the [classname] + [source, java] ---- -DateTimeFormatter formatter = DateTimeFormatter - .ofLocalizedDate(FormatStyle.LONG, FormatStyle.SHORT) - .withLocale(Locale.ENGLISH); +LocalDateTimeRenderer renderer = new LocalDateTimeRenderer( + () -> DateTimeFormatter + .ofLocalizedDateTime(FormatStyle.LONG, FormatStyle.SHORT) + .withLocale(Locale.ENGLISH)); Column<Person, LocalDateTime> bornColumn = - grid.addColumn( - Person::getBirthDateAndTime, - new LocalDateTimeRenderer(formatter)); + grid.addColumn(Person::getBirthDateAndTime, renderer); + // Alternatively, with a custom pattern: Column<Person, LocalDateTime> bornColumn = |