pax_global_header 0000666 0000000 0000000 00000000064 11574511370 0014516 g ustar 00root root 0000000 0000000 52 comment=59ef44d2c18f04c6c5f35a4d61cfde73e9f74d6b
localizer-1.13/ 0000775 0000000 0000000 00000000000 11574511370 0013426 5 ustar 00root root 0000000 0000000 localizer-1.13/lib/ 0000775 0000000 0000000 00000000000 11574511370 0014174 5 ustar 00root root 0000000 0000000 localizer-1.13/lib/pom.xml 0000664 0000000 0000000 00000001262 11574511370 0015512 0 ustar 00root root 0000000 0000000 4.0.0org.jvnet.localizerlocalizer-parent1.13../pom.xmllocalizerLocalizerjunitjunit4.0test
localizer-1.13/lib/src/ 0000775 0000000 0000000 00000000000 11574511370 0014763 5 ustar 00root root 0000000 0000000 localizer-1.13/lib/src/main/ 0000775 0000000 0000000 00000000000 11574511370 0015707 5 ustar 00root root 0000000 0000000 localizer-1.13/lib/src/main/java/ 0000775 0000000 0000000 00000000000 11574511370 0016630 5 ustar 00root root 0000000 0000000 localizer-1.13/lib/src/main/java/org/ 0000775 0000000 0000000 00000000000 11574511370 0017417 5 ustar 00root root 0000000 0000000 localizer-1.13/lib/src/main/java/org/jvnet/ 0000775 0000000 0000000 00000000000 11574511370 0020545 5 ustar 00root root 0000000 0000000 localizer-1.13/lib/src/main/java/org/jvnet/localizer/ 0000775 0000000 0000000 00000000000 11574511370 0022531 5 ustar 00root root 0000000 0000000 localizer-1.13/lib/src/main/java/org/jvnet/localizer/LocaleProvider.java 0000664 0000000 0000000 00000005073 11574511370 0026313 0 ustar 00root root 0000000 0000000 /*
* The MIT License
*
* Copyright (c) 2007-, the localizer project contributors
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package org.jvnet.localizer;
import java.util.Locale;
/**
* Determines the locale, normally from the context.
*
*
* For example, in webapps, you might use the current request's Accept-Language
* header, or maybe it's just an invocation to {@link Locale#getDefault()}.
*
*
* A single instance of {@link LocaleProvider} is maintained in this class
* for the use by {@link ResourceBundleHolder}.
*
* @author Kohsuke Kawaguchi
*/
public abstract class LocaleProvider {
/**
* Determines the locale to be used.
*
* @return
* must not be null.
*/
public abstract Locale get();
public static void setProvider(LocaleProvider p) {
if(p==null) throw new IllegalArgumentException();
theInstance = p;
}
/**
* Gets the currently installed system-wide {@link LocaleProvider}.
* @return
* always non-null.
*/
public static LocaleProvider getProvider() {
return theInstance;
}
/**
* Short for {@code getProvider().get()}
*/
public static Locale getLocale() {
return theInstance.get();
}
/**
* {@link LocaleProvider} that uses {@link Locale#getDefault()}.
*/
public static final LocaleProvider DEFAULT = new LocaleProvider() {
public Locale get() {
return Locale.getDefault();
}
};
private static volatile LocaleProvider theInstance = DEFAULT;
}
localizer-1.13/lib/src/main/java/org/jvnet/localizer/Localizable.java 0000664 0000000 0000000 00000005434 11574511370 0025623 0 ustar 00root root 0000000 0000000 /*
* The MIT License
*
* Copyright (c) 2007-, the localizer project contributors
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package org.jvnet.localizer;
import java.util.Locale;
import java.text.MessageFormat;
import java.io.Serializable;
import java.util.MissingResourceException;
import static java.util.Arrays.asList;
/**
* Captures the localizable string. Can be converted to a string just by
* supplying a {@link Locale}.
*
* @author Kohsuke Kawaguchi
*/
public class Localizable implements Serializable {
private final ResourceBundleHolder holder;
private final String key;
private final Serializable[] args;
public Localizable(ResourceBundleHolder holder, String key, Object... args) {
this.holder = holder;
this.key = key;
this.args = new Serializable[args.length];
for (int i = 0; i < args.length; i++) {
if (args[i] instanceof Serializable) {
this.args[i] = (Serializable)args[i];
} else {
// MessageFormat only supports formats of "number", "date", "time" and "choice"
// All of which will be formatting objects that must be Serializable
// Anything else will just have it's toString() method invoked
// by MessageFormat, so we'll just call toString up front.
this.args[i] = args[i].toString();
}
}
}
public String toString(Locale locale) {
try {
return MessageFormat.format(holder.get(locale).getString(key),args);
} catch (MissingResourceException e) {
throw new RuntimeException("Failed to localize key="+key+",args="+ asList(args),e);
}
}
public String toString() {
return toString(LocaleProvider.getLocale());
}
}
localizer-1.13/lib/src/main/java/org/jvnet/localizer/ResourceBundleHolder.java 0000664 0000000 0000000 00000013713 11574511370 0027460 0 ustar 00root root 0000000 0000000 /*
* The MIT License
*
* Copyright (c) 2007-, the localizer project contributors
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package org.jvnet.localizer;
import java.io.IOException;
import java.io.InputStream;
import java.io.Serializable;
import java.io.ObjectStreamException;
import java.net.URL;
import java.text.MessageFormat;
import java.util.*;
import java.util.concurrent.ConcurrentHashMap;
import java.lang.ref.WeakReference;
/**
* Maintains {@link ResourceBundle}s per locale.
*
* @author Kohsuke Kawaguchi
*/
public final class ResourceBundleHolder implements Serializable {
/** Need to cache, but not tie up a classloader refernce in cases of unloading */
private static final Map> cache =
new WeakHashMap> ();
/**
* Gets a {@link ResourceBundleHolder} for the given class,
* by utilizing a cache if possible.
*/
public synchronized static ResourceBundleHolder get(Class clazz) {
WeakReference entry = cache.get(clazz);
if (entry != null) {
ResourceBundleHolder rbh = entry.get();
if (rbh != null) return rbh;
}
ResourceBundleHolder rbh = new ResourceBundleHolder(clazz);
cache.put(clazz, new WeakReference(rbh));
return rbh;
}
private transient final Map bundles = new ConcurrentHashMap();
public final Class owner;
/**
* {@link Locale} object that corresponds to the base bundle.
*/
private static final Locale ROOT = new Locale("");
/**
* @param owner
* The name of the generated resource bundle class.
* @deprecated
* Use {@link #get(Class)}
*/
public ResourceBundleHolder(Class owner) {
this.owner = owner;
}
/**
* Work around deserialization issues.
*/
private Object readResolve() throws ObjectStreamException {
return get(owner);
}
/**
* Loads {@link ResourceBundle} for the locale.
*/
public ResourceBundle get(Locale locale) {
ResourceBundle rb = bundles.get(locale);
if(rb!=null) return rb;
// try to update the map
synchronized(this) {
rb = bundles.get(locale);
if(rb!=null) return rb;
// turns out this is totally unsable because the getBundle method
// always checks Locale.getDefault() and that wins over the bundle for the root locale.
// bundles.put(locale, rb=ResourceBundle.getBundle(owner.getName(),locale,owner.getClassLoader()));
Locale next = getBaseLocale(locale);
String s = locale.toString();
URL res = owner.getResource(owner.getSimpleName()+(s.length()>0?'_'+s:"")+".properties");
if(res!=null) {
// found property file for this locale.
try {
InputStream is = res.openStream();
ResourceBundleImpl bundle = new ResourceBundleImpl(is);
is.close();
rb = bundle;
if(next!=null)
bundle.setParent(get(next));
bundles.put(locale,bundle);
} catch (IOException e) {
MissingResourceException x = new MissingResourceException("Unable to load resource " + res, owner.getName(), null);
x.initCause(e);
throw x;
}
} else {
if(next!=null)
// no matching resource, so just use the locale for the base
bundles.put(locale,rb=get(next));
else
throw new MissingResourceException(
"No resource was found for "+owner.getName(),owner.getName(),null);
}
}
return rb;
}
@Override
public String toString() {
return getClass().getName()+"["+owner.getName()+"]";
}
static class ResourceBundleImpl extends PropertyResourceBundle {
ResourceBundleImpl(InputStream stream) throws IOException {
super(stream);
}
protected void setParent(ResourceBundle parent) {
super.setParent(parent);
}
}
/**
* Returns the locale to fall back to.
*/
private Locale getBaseLocale(Locale l) {
if (l.getVariant().length() > 0)
return new Locale(l.getLanguage(), l.getCountry());
if (l.getCountry().length() > 0)
return new Locale(l.getLanguage());
if (l.getLanguage().length()>0)
return ROOT;
return null;
}
/**
* Formats a resource specified by the given key by using the default locale
*/
public String format(String key, Object... args) {
return MessageFormat.format(get(LocaleProvider.getLocale()).getString(key),args);
}
}
localizer-1.13/lib/src/test/ 0000775 0000000 0000000 00000000000 11574511370 0015742 5 ustar 00root root 0000000 0000000 localizer-1.13/lib/src/test/java/ 0000775 0000000 0000000 00000000000 11574511370 0016663 5 ustar 00root root 0000000 0000000 localizer-1.13/lib/src/test/java/foo/ 0000775 0000000 0000000 00000000000 11574511370 0017446 5 ustar 00root root 0000000 0000000 localizer-1.13/lib/src/test/java/foo/LocaleTest.java 0000664 0000000 0000000 00000001335 11574511370 0022352 0 ustar 00root root 0000000 0000000 package foo;
import junit.framework.TestCase;
import java.util.Locale;
import org.jvnet.localizer.ResourceBundleHolder;
/**
* @author Kohsuke Kawaguchi
*/
public class LocaleTest extends TestCase {
public void test1() {
Locale.setDefault(Locale.GERMANY);
routineCheck();
}
public void test2() {
Locale.setDefault(Locale.ENGLISH);
routineCheck();
}
private void routineCheck() {
ResourceBundleHolder h = new ResourceBundleHolder(LocaleTest.class);
assertEquals("base",h.get(Locale.ENGLISH).getString("abc"));
assertEquals("german",h.get(Locale.GERMANY).getString("abc"));
assertEquals("german",h.get(Locale.GERMAN).getString("abc"));
}
}
localizer-1.13/lib/src/test/resources/ 0000775 0000000 0000000 00000000000 11574511370 0017754 5 ustar 00root root 0000000 0000000 localizer-1.13/lib/src/test/resources/foo/ 0000775 0000000 0000000 00000000000 11574511370 0020537 5 ustar 00root root 0000000 0000000 localizer-1.13/lib/src/test/resources/foo/LocaleTest.properties 0000664 0000000 0000000 00000000010 11574511370 0024703 0 ustar 00root root 0000000 0000000 abc=base localizer-1.13/lib/src/test/resources/foo/LocaleTest_de.properties 0000664 0000000 0000000 00000000012 11574511370 0025355 0 ustar 00root root 0000000 0000000 abc=german localizer-1.13/maven-plugin/ 0000775 0000000 0000000 00000000000 11574511370 0016030 5 ustar 00root root 0000000 0000000 localizer-1.13/maven-plugin/pom.xml 0000664 0000000 0000000 00000003201 11574511370 0017341 0 ustar 00root root 0000000 0000000 4.0.0org.jvnet.localizerlocalizer-parent1.13../pom.xmlmaven-localizer-pluginmaven-pluginLocalizer generatororg.apache.mavenmaven-plugin-api2.0.1org.apache.mavenmaven-archiver2.0.1org.codehaus.plexusplexus-utils1.0.4org.apache.mavenmaven-artifact2.0.1org.apache.antant1.7.0com.sun.codemodelcodemodel2.1${project.groupId}localizer${project.version}
localizer-1.13/maven-plugin/src/ 0000775 0000000 0000000 00000000000 11574511370 0016617 5 ustar 00root root 0000000 0000000 localizer-1.13/maven-plugin/src/main/ 0000775 0000000 0000000 00000000000 11574511370 0017543 5 ustar 00root root 0000000 0000000 localizer-1.13/maven-plugin/src/main/java/ 0000775 0000000 0000000 00000000000 11574511370 0020464 5 ustar 00root root 0000000 0000000 localizer-1.13/maven-plugin/src/main/java/org/ 0000775 0000000 0000000 00000000000 11574511370 0021253 5 ustar 00root root 0000000 0000000 localizer-1.13/maven-plugin/src/main/java/org/jvnet/ 0000775 0000000 0000000 00000000000 11574511370 0022401 5 ustar 00root root 0000000 0000000 localizer-1.13/maven-plugin/src/main/java/org/jvnet/localizer/ 0000775 0000000 0000000 00000000000 11574511370 0024365 5 ustar 00root root 0000000 0000000 localizer-1.13/maven-plugin/src/main/java/org/jvnet/localizer/Generator.java 0000664 0000000 0000000 00000015460 11574511370 0027164 0 ustar 00root root 0000000 0000000 /*
* The MIT License
*
* Copyright (c) 2007-, the localizer project contributors
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package org.jvnet.localizer;
import com.sun.codemodel.JClassAlreadyExistsException;
import com.sun.codemodel.JCodeModel;
import com.sun.codemodel.JDefinedClass;
import com.sun.codemodel.JExpr;
import com.sun.codemodel.JInvocation;
import com.sun.codemodel.JMethod;
import com.sun.codemodel.JMod;
import com.sun.codemodel.JVar;
import com.sun.codemodel.CodeWriter;
import com.sun.codemodel.JPackage;
import com.sun.codemodel.writer.FileCodeWriter;
import org.apache.tools.ant.DirectoryScanner;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.io.Writer;
import java.io.PrintWriter;
import java.text.MessageFormat;
import java.util.ArrayList;
import java.util.List;
import java.util.Map.Entry;
import java.util.Properties;
/**
* @author Kohsuke Kawaguchi
*/
public class Generator {
private final JCodeModel cm = new JCodeModel();
private final File outputDirectory;
private final Reporter reporter;
public Generator(File outputDirectory, Reporter reporter) {
this.outputDirectory = outputDirectory;
this.reporter = reporter;
}
public void generate(File baseDir, DirectoryScanner ds) throws IOException {
for( String relPath : ds.getIncludedFiles() ) {
File f = new File(baseDir,relPath);
if(!f.getName().endsWith(".properties") || f.getName().contains("_"))
continue;
try {
generate(f,relPath);
} catch (IOException e) {
IOException x = new IOException("Failed to generate a class from " + f);
x.initCause(e);
throw x;
}
}
}
public void generate(File propertyFile, String relPath) throws IOException {
String className = toClassName(relPath);
// up to date check
File sourceFile = new File(outputDirectory,className.replace('.','/')+".java");
if(sourceFile.exists() && sourceFile.lastModified()>propertyFile.lastModified()) {
reporter.debug(sourceFile+" is up to date");
return;
}
// go generate one
Properties props = new Properties();
FileInputStream in = new FileInputStream(propertyFile);
try {
props.load(in);
} catch (IOException e) {
in.close();
}
try {
JDefinedClass c = cm._class(className);
c.annotate(SuppressWarnings.class).paramArray("value").param("").param("PMD");
// [RESULT]
// private static final ResourceBundleHolder holder = BundleHolder.get(Messages.class);
JVar holder = c.field(JMod.PRIVATE | JMod.STATIC | JMod.FINAL, ResourceBundleHolder.class, "holder",
cm.ref(ResourceBundleHolder.class).staticInvoke("get").arg(c.dotclass()) );
for (Entry e : props.entrySet()) {
String key = e.getKey().toString();
String value = e.getValue().toString();
int n = countArgs(value);
// generate the default format method
List args = new ArrayList();
JMethod m = c.method(JMod.PUBLIC | JMod.STATIC, cm.ref(String.class), toJavaIdentifier(key));
for( int i=1; i<=n; i++ )
args.add(m.param(Object.class,"arg"+i));
JInvocation inv = holder.invoke("format").arg(key);
for (JVar arg : args)
inv.arg(arg);
m.body()._return(inv);
m.javadoc().add(escape(value));
// generate localizable factory
args.clear();
m = c.method(JMod.PUBLIC | JMod.STATIC, cm.ref(Localizable.class), '_'+toJavaIdentifier(key));
for( int i=1; i<=n; i++ )
args.add(m.param(Object.class,"arg"+i));
inv = JExpr._new(cm.ref(Localizable.class)).arg(holder).arg(key);
for (JVar arg : args)
inv.arg(arg);
m.body()._return(inv);
m.javadoc().add(escape(value));
}
} catch (JClassAlreadyExistsException e) {
throw new AssertionError(e);
}
}
private String escape(String value) {
return value.replace("&","&").replace("<","<");
}
/**
* Counts the number of arguments.
*/
protected int countArgs(String formatString) {
return new MessageFormat(formatString).getFormatsByArgumentIndex().length;
}
protected String toJavaIdentifier(String key) {
// TODO: this is fairly dumb implementation
return key.replace('.','_').replace('-','_').replace('/','_');
}
protected String toClassName(String relPath) {
relPath = relPath.substring(0,relPath.length()-".properties".length());
return relPath.replace(File.separatorChar,'.');
}
public JCodeModel getCodeModel() {
return cm;
}
public void build() throws IOException {
outputDirectory.mkdirs();
cm.build(new CodeWriter() {
private final CodeWriter delegate = new FileCodeWriter(outputDirectory);
public Writer openSource(JPackage pkg, String fileName) throws IOException {
Writer w = super.openSource(pkg, fileName);
new PrintWriter(w).println("// CHECKSTYLE:OFF");
return w;
}
public void close() throws IOException {
delegate.close();
}
public OutputStream openBinary(JPackage pkg, String fileName) throws IOException {
return delegate.openBinary(pkg, fileName);
}
});
}
}
localizer-1.13/maven-plugin/src/main/java/org/jvnet/localizer/GeneratorMojo.java 0000664 0000000 0000000 00000010016 11574511370 0030001 0 ustar 00root root 0000000 0000000 /*
* The MIT License
*
* Copyright (c) 2007-, the localizer project contributors
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package org.jvnet.localizer;
import org.apache.maven.model.Resource;
import org.apache.maven.plugin.AbstractMojo;
import org.apache.maven.plugin.MojoExecutionException;
import org.apache.maven.plugin.MojoFailureException;
import org.apache.maven.project.MavenProject;
import org.apache.tools.ant.Project;
import org.apache.tools.ant.types.FileSet;
import java.io.File;
import java.io.IOException;
import java.util.List;
/**
* @author Kohsuke Kawaguchi
* @goal generate
* @phase generate-sources
*/
public class GeneratorMojo extends AbstractMojo {
/**
* The maven project.
*
* @parameter expression="${project}"
* @required
* @readonly
*/
protected MavenProject project;
/**
* The directory to place generated property files.
*
* @parameter default-value="${project.build.directory}/generated-sources"
* @required
*/
protected File outputDirectory;
/**
* Additional file name mask like "Messages.properties" to further
* restrict the resource processing.
*
* @parameter
*/
protected String fileMask;
public void execute() throws MojoExecutionException, MojoFailureException {
String pkg = project.getPackaging();
if(pkg!=null && pkg.equals("pom"))
return; // skip POM modules
Generator g = new Generator(outputDirectory, new Reporter() {
public void debug(String msg) {
getLog().debug(msg);
}
});
for(Resource res : (List)project.getResources()) {
File baseDir = new File(res.getDirectory());
if(!baseDir.exists())
continue; // this happens for example when POM inherits the default resource folder but no such folder exists.
FileSet fs = new FileSet();
fs.setDir(baseDir);
for( String name : (List)res.getIncludes() )
fs.createInclude().setName(name);
for( String name : (List)res.getExcludes() )
fs.createExclude().setName(name);
for( String relPath : fs.getDirectoryScanner(new Project()).getIncludedFiles() ) {
File f = new File(baseDir,relPath);
if(!f.getName().endsWith(".properties") || f.getName().contains("_"))
continue;
if(fileMask!=null && !f.getName().equals(fileMask))
continue;
try {
g.generate(f,relPath);
} catch (IOException e) {
throw new MojoExecutionException("Failed to generate a class from "+f,e);
}
}
}
try {
g.build();
} catch (IOException e) {
throw new MojoExecutionException("Failed to generate source files",e);
}
project.addCompileSourceRoot(outputDirectory.getAbsolutePath());
}
}
localizer-1.13/maven-plugin/src/main/java/org/jvnet/localizer/GeneratorTask.java 0000664 0000000 0000000 00000004121 11574511370 0027777 0 ustar 00root root 0000000 0000000 /*
* The MIT License
*
* Copyright (c) 2007-, the localizer project contributors
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package org.jvnet.localizer;
import org.apache.tools.ant.taskdefs.MatchingTask;
import org.apache.tools.ant.BuildException;
import org.apache.tools.ant.Project;
import java.io.File;
import java.io.IOException;
/**
* Ant task for resource generation.
*
* @author Kohsuke Kawaguchi
*/
public class GeneratorTask extends MatchingTask {
/**
* Source and destination.
*/
private File dir,todir;
public void setDir(File dir) {
this.dir = dir;
}
public void setTodir(File todir) {
this.todir = todir;
}
public void execute() throws BuildException {
Generator g = new Generator(todir,new Reporter() {
public void debug(String msg) {
log(msg, Project.MSG_DEBUG);
}
});
try {
g.generate(dir,getDirectoryScanner(dir));
g.build();
} catch (IOException e) {
throw new BuildException(e);
}
}
}
localizer-1.13/maven-plugin/src/main/java/org/jvnet/localizer/Reporter.java 0000664 0000000 0000000 00000002410 11574511370 0027027 0 ustar 00root root 0000000 0000000 /*
* The MIT License
*
* Copyright (c) 2007-, the localizer project contributors
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package org.jvnet.localizer;
/**
* @author Kohsuke Kawaguchi
*/
public interface Reporter {
void debug(String msg);
}
localizer-1.13/pom.xml 0000664 0000000 0000000 00000003331 11574511370 0014743 0 ustar 00root root 0000000 0000000 4.0.0org.jvnet.localizerlocalizer-parentpom1.13Localizer parent POMlibmaven-pluginscm:svn:https://svn.java.net/svn/localizer~svn/tags/localizer-parent-1.13scm:svn:https://svn.java.net/svn/localizer~svn/tags/localizer-parent-1.13The MIT licensehttp://www.opensource.org/licenses/mit-license.phprepomaven-compiler-plugin1.51.5maven.jenkins-ci.orghttp://maven.jenkins-ci.org:8081/content/repositories/releasesmaven.jenkins-ci.orghttp://maven.jenkins-ci.org:8081/content/repositories/snapshotsjava.net2http://download.java.net/maven/2/
localizer-1.13/src/ 0000775 0000000 0000000 00000000000 11574511370 0014215 5 ustar 00root root 0000000 0000000 localizer-1.13/src/site/ 0000775 0000000 0000000 00000000000 11574511370 0015161 5 ustar 00root root 0000000 0000000 localizer-1.13/src/site/apt/ 0000775 0000000 0000000 00000000000 11574511370 0015745 5 ustar 00root root 0000000 0000000 localizer-1.13/src/site/apt/index.apt 0000664 0000000 0000000 00000006605 11574511370 0017571 0 ustar 00root root 0000000 0000000 What is this?
This small tool reads your property files and generate Java classes
that enables type-safe access to message resources.
For example, when you have a property file called <<>>
that looks like this:
-----------------------------------------
foo=error at {0} with {1}
-----------------------------------------
this tool generates the following <<>>:
-----------------------------------------
public class Messages {
private final static ResourceBundleHolder holder = new ResourceBundleHolder(Messages.class);
/**
* error at {0} with {1}
*/
public static String foo(Object arg1, Object arg2) {
return holder.format("foo",arg1,arg2);
}
/**
* error at {0} with {1}
*/
public static Localizable _foo(Object arg1, Object arg2) {
return new Localizable(holder, "foo", arg1, arg2);
}
}
-----------------------------------------
The first method formats the message by using the default locale,
and the second method returns an object that can be later formatted
into <<>> by specifying Locale.
In this way, you can get auto-completion on choosing the right message,
you'll never refer to a non-existent message, and you'll always use
the right number of arguments.
How to use this?
For projects built with Maven, add the following entries to your POM.
For the list of configurations to the <<>>,
refer to {{{#}this document}}:
-----------------------------------------
...
...
org.jvnet.localizermaven-localizer-plugingenerateorg.jvnet.localizerlocalizer1.0
...
java.net2http://download.java.net/maven/2/
...
-----------------------------------------
For projects built with Ant, use the following task to generate source files:
-----------------------------------------
-----------------------------------------
The <<>> task is a
{{{http://ant.apache.org/manual/dirtasks.html}matching task}},
so you can use the usual FileSet-based filtering technique to
specify the property files to be processed.
Using LocaleProvider
When you use methods that return <<>>, the implementation
consults a singleton <<>> for determining the locale
to be used.
The default implementation simply returns <<>>,
but in other situations (for example in web apps), you can have this
method return different locales (for example by using
<<>>.) localizer-1.13/src/site/site.xml 0000664 0000000 0000000 00000001217 11574511370 0016650 0 ustar 00root root 0000000 0000000
org.jvnet.maven-javanet-skinmaven-javanet-skin1.0
${reports}
localizer-1.13/test/ 0000775 0000000 0000000 00000000000 11574511370 0014405 5 ustar 00root root 0000000 0000000 localizer-1.13/test/pom.xml 0000664 0000000 0000000 00000001557 11574511370 0015732 0 ustar 00root root 0000000 0000000 4.0.0org.jvnet.localizerlocalizer-parent1.4-SNAPSHOT../pom.xmllocalizer-testLocalizer test moduleorg.jvnet.localizermaven-localizer-plugingenerate${project.groupId}localizer${project.version}
localizer-1.13/test/src/ 0000775 0000000 0000000 00000000000 11574511370 0015174 5 ustar 00root root 0000000 0000000 localizer-1.13/test/src/main/ 0000775 0000000 0000000 00000000000 11574511370 0016120 5 ustar 00root root 0000000 0000000 localizer-1.13/test/src/main/resources/ 0000775 0000000 0000000 00000000000 11574511370 0020132 5 ustar 00root root 0000000 0000000 localizer-1.13/test/src/main/resources/org/ 0000775 0000000 0000000 00000000000 11574511370 0020721 5 ustar 00root root 0000000 0000000 localizer-1.13/test/src/main/resources/org/jvnet/ 0000775 0000000 0000000 00000000000 11574511370 0022047 5 ustar 00root root 0000000 0000000 localizer-1.13/test/src/main/resources/org/jvnet/localizer/ 0000775 0000000 0000000 00000000000 11574511370 0024033 5 ustar 00root root 0000000 0000000 localizer-1.13/test/src/main/resources/org/jvnet/localizer/test/ 0000775 0000000 0000000 00000000000 11574511370 0025012 5 ustar 00root root 0000000 0000000 localizer-1.13/test/src/main/resources/org/jvnet/localizer/test/Messages.properties 0000664 0000000 0000000 00000000076 11574511370 0030702 0 ustar 00root root 0000000 0000000 abc=Test message {0} and {1}
def=Another message {0}
ghi=*/*
localizer-1.13/test/src/main/resources/org/jvnet/localizer/test/test.jpeg 0000664 0000000 0000000 00000000000 11574511370 0026626 0 ustar 00root root 0000000 0000000