- cal10n-user - mailman3.qos.ch

Performance comparison Cal10n vs usual implementation of i10n in Java
by Eveline Ushner 11 Oct '16

11 Oct '16

Dear Cal10n-user subscribers, This is my first post to the mailing list, so please be gentle with me. I have a few question about the performance of the Cal10n library. On the website of Cal10n, a time indication is given about the impact of one key look-up. Quote: "good performance (300 nanoseconds per key look-up)" From: http://cal10n.qos.ch/ My questions about the Cal10n library are: 1. How does the 300nsec performance relate to the normal Java solution using i10n (resource bundles)? 2. Is there any performance decay when using Cal10n instead of standard Java i10n? What is the performance decay in numbers, if any? 3. Is it possible to use the Cal10n to override the normal Java i10n in certain situations that are 'fixed'? This needs some explaining: I want to use localization in exception throwing cases. I know I can customize exceptions (e.g. make my own exceptions or wrap default exceptions), but in some cases I cannot customize these exception messages because a java.lang.ArithmeticException is thrown (for example), and wrapping them is not a good idea. The 'problem' is that I have, in some cases, no control over these exceptions, but would like to see that the exception message is actual in the selected Locale/Language rather than the de-facto English language. Somehow, I think that the Cal10n could "hook up" with this normal exception and inject a different message (aka override its default message within another language). Or is this wishful thinking? 4. Current development plans start to become clear for a new project in which the performance is the biggest requirement of all: "less is best" (meaning: the quicker the better, and not: less performance is better, FTW). I need to know upfront how much this Cal10n library effects the overall performance when all messages run through this library. If there are 10000 messages to be processed on the fly, in which 300ns per message is taken, that would mean a performance issue (3ms for resource lookup?). The question is: can the library be turned off, so that the difference is measured with and without the Cal10n library, and without having to remove the Cal10n specific code in order to improve performance? A 300nsec performance is no big deal for some situations, but if you need to handle bulk messages (in terms of terabytes), a 300ns EXTRA performance decrease takes its toll. Therefore also my question #2. 5. Does Cal10n cache the enums that are used most frequently, so when a lot of the same messages are logged, not each enum lookup has to occur. For example, cache the last 50 enums so that they do not have to be reloaded each time? I am not sure how this works internally with resource bundles or with Cal10n. The only thing that needs to be done is get the cached localized message and the detailed info that is given within that specific message. 6. What is the difference between the Cal10n approach and the Enum-With-String ids approach? See this question on StackOverflow: http://stackoverflow.com/questions/15380243/how-to-retrieve-enum-name-using… You could do 'almost the same' with enums and strings to do a lookup of a message and couple it to a resource bundle, right? So in what perception is the Cal10n solution "better" than the other available solutions (e.g. ResourceBundle, Enum-String-id)? 7. Some points to consider: There is no FAQ on the website of Cal10n. I assume more people like me have the same kind of questions? There is a missing link on the website of Cal10n: On this page http://cal10n.qos.ch/manual.html the link to the technical article about ResourceBundles is referring to a non-existing page/website. Old: http://java.sun.com/developer/technicalArticles/Intl/ResourceBundles/ New: https://docs.oracle.com/javase/tutorial/i18n/TOC.html or https://docs.oracle.com/javase/tutorial/i18n/resbundle/concept.html These are my questions (so far). Thanks in advance for answering my questions. Best regards, Eveline Ushner

1 0

single instance of MessageConveyor
by Yoni Moses 07 Jul '13

07 Jul '13

Hi, I'm just confirming that actually.. is it possible to hold a singleton for MessageConveyor per locale? Cheers, Yoni

1 0

cal10n 0.8.1 CAL10NBundleFinderByProcessingFiler.getResource()
by Michael Newcomb 15 May '13

15 May '13

cal10n is not able to find my resource bundles. It keeps failing saying that it can't find my resource bundle... I've tried to understand the code, but it is not very easy to follow. It seems like it is using the @BaseName.value as the basename for the file, but it replaces '.' with '/' as if the basename would be a package. That sounds bad because if you refactor the class the @BaseName is in you would need to make sure it catches that text package reference. Anyway, I traced the problem down into CAL10NBundleFinderByProcessingFiler.getResource(). It uses StandardLocation.CLASS_OUTPUT... to look for the file. Then AbstractCAL10NBundleFinder.makePropertyResourceBundle() quietly swallows the exception that results when it can't find the resource bundle. So, I guess I'm asking, where do you put your resource bundle when you follow the example in the documentation: package com.foo.somePackage; import ch.qos.cal10n.LocaleData; import ch.qos.cal10n.Locale; import ch.qos.cal10n.BaseName; @BaseName("colors") @LocaleData( { @Locale("en_UK"), @Locale("fr") }) public enum Colors { BLUE, RED, YELLOW; } I've tried just putting 'colors_en_UK.properties' in the com.foo.somePackage directory, but that doesn't work because it looks for that file in <outputdir>/com/foo/somePackage and it isn't there. I put my resources in a separate folder called 'resources'. I didn't have that on my javac sourcepath, but I can add that to handle the cal10n annotation processing. However, StandardLocation.CLASS_OUTPUT would need to changed to StandardLocation.SOURCE_PATH. I debugged it and re-assigned the result to use SOURCE_PATH and it behaves like I felt that it should... Perhaps the CAL10NBundleFinderByProcessingFiler can search most/all of the StandardLocation.* places instead of just one? Anyway, it is late and I didn't want to tear up my codebase to figure out how to make it work, so I'm asking where we should put these things and what names should they be given... Thanks, Michael

1 0

Release of CAL10N v0.8.1
by ceki 13 Apr '13

13 Apr '13

Hello all, Only a day after 0.8, I am happy to announce the availability of cal10n version 0.8.1 which reverts an backward incompatible change introduced in 0.8. Please avoid version 0.8, instead use 0.8.1 or later. Compiler Assisted Localization, abbreviated as CAL10N (pronounced as "calion") is a java library for writing localized (internationalized) messages. It supports java compiler verification of message keys used in source code and tooling to detect errors in message keys. The 0.8.x series brings support for JSR-269 annotation processors. In other words, verification of bundles can be performed at compilation time. For details see the documentation at: http://cal10n.qos.ch/manual.html#jsr269 You can download CAL10N, including full source code, class files and documentation on our download page, shown below. http://cal10n.qos.ch/download.html You can receive CAL10N related announcements by subscribing to the QOS.ch announce mailing list. To subscribe to QOS.ch announce list, please visit the following URL. http://www.qos.ch/mailman/listinfo/announce Enjoy, -- Ceki 65% of statistics are made up on the spot

1 0

Release of CAL10N v0.8
by ceki 12 Apr '13

12 Apr '13

Hello all, I am happy to announce the immediate availability of cal10n version 0.8. This release adds JSR-269 support. In other words, verification of bundles can be performed at compilation time. For details see the documentation at: http://cal10n.qos.ch/manual.html#jsr269 Compiler Assisted Localization, abbreviated as CAL10N (pronounced as "calion") is a java library for writing localized (internationalized) messages. It supports java compiler verification of message keys used in source code and tooling to detect errors in message keys. You can download CAL10N, including full source code, class files and documentation on our download page, shown below. http://cal10n.qos.ch/download.html You can receive CAL10N related announcements by subscribing to the QOS.ch announce mailing list. To subscribe to QOS.ch announce list, please visit the following URL. http://www.qos.ch/mailman/listinfo/announce Enjoy, -- Ceki 65% of statistics are made up on the spot

1 0

Release of CAL10N v0.7.6
by ceki 14 Mar '13

14 Mar '13

Hello all, I am happy to announce the immediate availability of cal10n version 0.7.6, a maintenance release containing bug fixes. Please refer to the the news page for precise details. http://cal10n.qos.ch/news.html Compiler Assisted Localization, abbreviated as CAL10N (pronounced as "calion") is a java library for writing localized (internationalized) messages. It supports java compiler verification of message keys used in source code and tooling to detect errors in message keys. You can download CAL10N, including full source code, class files and documentation on our download page, shown below. http://cal10n.qos.ch/download.html You can receive CAL10N related announcements by subscribing to the QOS.ch announce mailing list. To subscribe to QOS.ch announce list, please visit the following URL. http://www.qos.ch/mailman/listinfo/announce Enjoy, -- Ceki 65% of statistics are made up on the spot

1 0

Release of CAL10N v0.7.5
by ceki 26 Feb '13

26 Feb '13

Hello all, I am happy to announce the immediate availability of cal10n version 0.7.5, a maintenance release containing only minor fixes. Please refer to the the news page for precise details. http://cal10n.qos.ch/news.html Compiler Assisted Localization, abbreviated as CAL10N (pronounced as "calion") is a java library for writing localized (internationalized) messages. It supports java compiler verification of message keys used in source code and tooling to detect errors in message keys. You can download CAL10N, including full source code, class files and documentation on our download page, shown below. http://cal10n.qos.ch/download.html You can receive CAL10N related announcements by subscribing to the QOS.ch announce mailing list. To subscribe to QOS.ch announce list, please visit the following URL. http://www.qos.ch/mailman/listinfo/announce Enjoy, -- Ceki 65% of statistics are made up on the spot

1 0

Re: [cal10n-user] cal10n-user Digest, Vol 2, Issue 1
by Desmond Kirrane 06 Feb '13

06 Feb '13

I've raised a JIRA for this: http://jira.qos.ch/browse/CAL-36 On Wed, Feb 6, 2013 at 11:00 AM, <cal10n-user-request(a)qos.ch> wrote: > Send cal10n-user mailing list submissions to > cal10n-user(a)qos.ch > > To subscribe or unsubscribe via the World Wide Web, visit > http://mailman.qos.ch/mailman/listinfo/cal10n-user > or, via email, send a message with subject or body 'help' to > cal10n-user-request(a)qos.ch > > You can reach the person managing the list at > cal10n-user-owner(a)qos.ch > > When replying, please edit your Subject line so it is more specific > than "Re: Contents of cal10n-user digest..." > > > Today's Topics: > > 1. ch.qos.cal10n.MessageConveyorException (Desmond Kirrane) > 2. Re: ch.qos.cal10n.MessageConveyorException (Michael) > > > ---------------------------------------------------------------------- > > Message: 1 > Date: Tue, 5 Feb 2013 18:41:13 +0000 > From: Desmond Kirrane <desmond.kirrane(a)gmail.com> > To: cal10n-user(a)qos.ch > Subject: [cal10n-user] ch.qos.cal10n.MessageConveyorException > Message-ID: > <CABXsE+zv9XCdG4sixdBPNQHEaoCWQwT= > SDwGRTW+38aU-QVxGQ(a)mail.gmail.com> > Content-Type: text/plain; charset="iso-8859-1" > > Hi, > > I'm getting the following message when I log: > > ch.qos.cal10n.MessageConveyorException: Failed to locate resource bundle > [Bundle] for locale [en_US] for enum type [com.mycompany.Messages] > at ch.qos.cal10n.MessageConveyor.lookup(MessageConveyor.java:115) > at ch.qos.cal10n.MessageConveyor.getMessage(MessageConveyor.java:77) > at org.slf4j.cal10n.LocLogger.error(LocLogger.java:167) > > > I have a default Bundle.properties in my classpath but cal10n doesn't use > it. > Everything works fine when I have a Bundle_en_US.properties. > > Is there a way to tell cal10n to use the default Bundle.properties if a > suitable bundle for the Locale it requires is missing? >

3 2

ch.qos.cal10n.MessageConveyorException
by Desmond Kirrane 05 Feb '13

05 Feb '13

Hi, I'm getting the following message when I log: ch.qos.cal10n.MessageConveyorException: Failed to locate resource bundle [Bundle] for locale [en_US] for enum type [com.mycompany.Messages] at ch.qos.cal10n.MessageConveyor.lookup(MessageConveyor.java:115) at ch.qos.cal10n.MessageConveyor.getMessage(MessageConveyor.java:77) at org.slf4j.cal10n.LocLogger.error(LocLogger.java:167) I have a default Bundle.properties in my classpath but cal10n doesn't use it. Everything works fine when I have a Bundle_en_US.properties. Is there a way to tell cal10n to use the default Bundle.properties if a suitable bundle for the Locale it requires is missing?

2 1

Re: [cal10n-user] Why is the default resource bundle ignored?
by Johannes Dorn 08 Jan '13

08 Jan '13

We have also encountered this problem. Is there a workaround or fix in the works? Unless we misunderstand something, cal10n hardly seems usable without being able to have a fallback properties file. Thanks, Johannes

3 2