All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.skife.jdbi.v2.sqlobject.stringtemplate.StringTemplate3StatementLocator Maven / Gradle / Ivy

/*
 * Copyright (C) 2004 - 2013 Brian McCallister
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.skife.jdbi.v2.sqlobject.stringtemplate;

import org.antlr.stringtemplate.StringTemplate;
import org.antlr.stringtemplate.StringTemplateErrorListener;
import org.antlr.stringtemplate.StringTemplateGroup;
import org.antlr.stringtemplate.language.AngleBracketTemplateLexer;
import org.skife.jdbi.v2.StatementContext;
import org.skife.jdbi.v2.tweak.StatementLocator;

import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.nio.charset.Charset;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.ConcurrentMap;
import java.util.regex.Matcher;

public class StringTemplate3StatementLocator implements StatementLocator
{
    private static final Charset UTF_8 = Charset.forName("UTF-8");
    private static final ConcurrentMap ANNOTATION_LOCATOR_CACHE;
    private static final String SUPER_SEPARATOR = " > ";

    public static final String TEMPLATE_GROUP_EXTENSION = ".sql.stg";

    static {
        final ConcurrentMap cache = new ConcurrentHashMap();
        cache.put("empty template group", new StringTemplateGroup("empty template group", AngleBracketTemplateLexer.class));
        ANNOTATION_LOCATOR_CACHE = cache;
    }

    private final StringTemplateGroup literals = new StringTemplateGroup("literals", AngleBracketTemplateLexer.class);
    private final StringTemplateGroup group;
    private final boolean treatLiteralsAsTemplates;

    public static final StringTemplate3StatementLocator.Builder builder(Class baseClass)
    {
        return new Builder(baseClass);
    }

    public static final StringTemplate3StatementLocator.Builder builder(String templateGroupFilePathOnClasspath)
    {
        return new Builder(templateGroupFilePathOnClasspath);
    }

    /**
     * Use {@link StringTemplate3StatementLocator#builder()} and {@link StringTemplate3StatementLocator.Builder}.
     */
    @Deprecated
    public StringTemplate3StatementLocator(Class baseClass)
    {
        this(mungify(baseClass),
             null,
             null,
             false,
             false,
             false);
    }

    /**
     * Use {@link StringTemplate3StatementLocator#builder()} and {@link StringTemplate3StatementLocator.Builder}.
     */
    @Deprecated
    public StringTemplate3StatementLocator(Class baseClass,
                                           boolean allowImplicitTemplateGroup,
                                           boolean treatLiteralsAsTemplates)
    {
        this(mungify(baseClass),
             null,
             null,
             allowImplicitTemplateGroup,
             treatLiteralsAsTemplates,
             false);
    }

    /**
     * Use {@link StringTemplate3StatementLocator#builder()} and {@link StringTemplate3StatementLocator.Builder}.
     */
    @Deprecated
    public StringTemplate3StatementLocator(String templateGroupFilePathOnClasspath)
    {
        this(templateGroupFilePathOnClasspath,
             null,
             null,
             false,
             false,
             false);
    }

    /**
     * Use {@link StringTemplate3StatementLocator#builder()} and {@link StringTemplate3StatementLocator.Builder}.
     */
    @Deprecated
    public StringTemplate3StatementLocator(String templateGroupFilePathOnClasspath,
                                           boolean allowImplicitTemplateGroup,
                                           boolean treatLiteralsAsTemplates)
    {
        this(templateGroupFilePathOnClasspath,
             null,
             null,
             allowImplicitTemplateGroup,
             treatLiteralsAsTemplates,
             false);
    }

    /**
     * Use {@link StringTemplate3StatementLocator#builder()} and {@link StringTemplate3StatementLocator.Builder}.
     */
    @Deprecated
    public StringTemplate3StatementLocator(Class baseClass,
                                           boolean allowImplicitTemplateGroup,
                                           boolean treatLiteralsAsTemplates,
                                           boolean shouldCache)
    {
        this(mungify(baseClass),
             null,
             null,
             allowImplicitTemplateGroup,
             treatLiteralsAsTemplates,
             shouldCache);
    }

    /**
     * Use {@link StringTemplate3StatementLocator#builder()} and {@link StringTemplate3StatementLocator.Builder}.
     */
    @Deprecated
    public StringTemplate3StatementLocator(String templateGroupFilePathOnClasspath,
                                           boolean allowImplicitTemplateGroup,
                                           boolean treatLiteralsAsTemplates,
                                           boolean shouldCache)
    {
        this(templateGroupFilePathOnClasspath,
             null,
             null,
             allowImplicitTemplateGroup,
             treatLiteralsAsTemplates,
             shouldCache);
    }

    private StringTemplate3StatementLocator(String templateGroupFilePathOnClasspath,
                                            String superTemplateGroupFilePathOnClasspath,
                                            StringTemplateErrorListener errorListener,
                                            boolean allowImplicitTemplateGroup,
                                            boolean treatLiteralsAsTemplates,
                                            boolean shouldCache)
    {
        this.treatLiteralsAsTemplates = treatLiteralsAsTemplates;

        final StringTemplateGroup superGroup;

        final StringBuilder sb = new StringBuilder(templateGroupFilePathOnClasspath);

        if (superTemplateGroupFilePathOnClasspath != null) {
            sb.append(SUPER_SEPARATOR).append(superTemplateGroupFilePathOnClasspath);

            superGroup = createGroup(superTemplateGroupFilePathOnClasspath,
                errorListener,
                shouldCache ? superTemplateGroupFilePathOnClasspath : null,
                allowImplicitTemplateGroup,
                getClass(),
                null);
        }
        else {
            superGroup = null;
        }

        this.group = createGroup(templateGroupFilePathOnClasspath,
            errorListener,
            shouldCache ? sb.toString() : null,
            allowImplicitTemplateGroup,
            getClass(),
            superGroup);
    }

    private static StringTemplateGroup createGroup(final String templateGroupFilePathOnClasspath,
                                                   final StringTemplateErrorListener errorListener,
                                                   final String cacheKey,
                                                   final boolean allowImplicitTemplateGroup,
                                                   final Class clazz,
                                                   final StringTemplateGroup superGroup)
    {
        if (cacheKey != null && ANNOTATION_LOCATOR_CACHE.containsKey(cacheKey)) {
            return ANNOTATION_LOCATOR_CACHE.get(cacheKey);
        }

        InputStream ins = clazz.getResourceAsStream(templateGroupFilePathOnClasspath);

        if (allowImplicitTemplateGroup && ins == null) {
            return ANNOTATION_LOCATOR_CACHE.get("empty template group");
        }
        else if (ins == null) {
            throw new IllegalStateException("unable to find group file "
                + templateGroupFilePathOnClasspath
                + " on classpath");
        }
        else {
            InputStreamReader reader = new InputStreamReader(ins, UTF_8);
            StringTemplateGroup result;

            if (superGroup == null) {
                result = new StringTemplateGroup(reader, AngleBracketTemplateLexer.class, errorListener);
            }
            else {
                result = new StringTemplateGroup(reader, AngleBracketTemplateLexer.class, errorListener, superGroup);
            }

            if (cacheKey != null) {
                StringTemplateGroup oldGroup = ANNOTATION_LOCATOR_CACHE.putIfAbsent(cacheKey, result);
                if (oldGroup != null) {
                    result = oldGroup;
                }
            }

            try {
                reader.close();
            }
            catch (IOException e) {
                throw new IllegalStateException("unable to load string template group " + templateGroupFilePathOnClasspath, e);
            }

            return result;
        }
    }

    public String locate(String name, StatementContext ctx) throws Exception
    {
        if (group.isDefined(name)) {
            // yeah, found template for it!
            StringTemplate t = group.getInstanceOf(name);
            t.reset();
            for (Map.Entry entry : ctx.getAttributes().entrySet()) {
                t.setAttribute(entry.getKey(), entry.getValue());
            }
            return t.toString();
        }
        else if (treatLiteralsAsTemplates) {
            // no template in the template group, but we want literals to be templates
            final String key = new String(new Base64().encode(name.getBytes(UTF_8)), UTF_8);
            if (!literals.isDefined(key)) {
                literals.defineTemplate(key, name);
            }
            StringTemplate t = literals.lookupTemplate(key);
            for (Map.Entry entry : ctx.getAttributes().entrySet()) {
                t.setAttribute(entry.getKey(), entry.getValue());
            }
            return t.toString();
        }
        else {
            // no template, no literals as template, just use the literal as sql
            return name;
        }
    }

    private static final String sep = "/"; // *Not* System.getProperty("file.separator"), which breaks in jars

    private static String mungify(Class clazz)
    {
        return "/" + clazz.getName().replaceAll("\\.", Matcher.quoteReplacement(sep)) + TEMPLATE_GROUP_EXTENSION;
    }

    // @VisibleForTesting
    static boolean templateCached(final Class clazzKey, Class superKey)
    {
        final StringBuilder sb = new StringBuilder(mungify(clazzKey));
        if (superKey != null) {
            sb.append(SUPER_SEPARATOR);
            sb.append(mungify(superKey));
        }
        return ANNOTATION_LOCATOR_CACHE.containsKey(sb.toString());
    }

    public static class Builder
    {
        private final String basePath;
        private String superGroupPath;
        private StringTemplateErrorListener errorListener = null;
        private boolean allowImplicitTemplateGroupEnabled = false;
        private boolean treatLiteralsAsTemplatesEnabled = false;
        private boolean shouldCacheEnabled = false;

        Builder(final Class baseClass)
        {
            this.basePath = mungify(baseClass);
        }

        Builder(final String basePath)
        {
            this.basePath = basePath;
        }

        public Builder withSuperGroup(final Class superGroupClass)
        {
            this.superGroupPath = mungify(superGroupClass);
            return this;
        }

        public Builder withSuperGroup(final String superGroupPath)
        {
            this.superGroupPath = superGroupPath;
            return this;
        }

        public Builder withErrorListener(final StringTemplateErrorListener errorListener)
        {
            this.errorListener = errorListener;
            return this;
        }

        public Builder allowImplicitTemplateGroup()
        {
            this.allowImplicitTemplateGroupEnabled = true;
            return this;
        }

        public Builder treatLiteralsAsTemplates()
        {
            this.treatLiteralsAsTemplatesEnabled = true;
            return this;
        }

        public Builder shouldCache()
        {
            this.shouldCacheEnabled = true;
            return this;
        }

        public StringTemplate3StatementLocator build()
        {
            return new StringTemplate3StatementLocator(basePath,
                                                       superGroupPath,
                                                       errorListener,
                                                       allowImplicitTemplateGroupEnabled,
                                                       treatLiteralsAsTemplatesEnabled,
                                                       shouldCacheEnabled);
        }
    }
}




© 2015 - 2025 Weber Informatics LLC | Privacy Policy