Search in sources :

Example 1 with PropertyFile

use of com.peterphi.std.io.PropertyFile in project stdlib by petergeneric.

the class GuiceFactory method build.

/**
 * Build a guice environment; this is achieved in the following stages:
 * <ol>
 * <li>Load GuiceRole implementations using {@link ServiceLoader} Service Provider Interface</li>
 * <li>Allow all GuiceRole instances to add/remove/change base configuration</li>
 * <li>Load configuration file resources (e.g. environment.properties)</li>
 * <li>Load network configuration (if enabled)</li>
 * <li>Add special GuiceRole for network configuration auto-reload (if network configuration enabled)</li>
 * <li>Load the override configuration file (if present)</li>
 * <li>Set up the classpath scanner (using property {@link GuiceProperties#SCAN_PACKAGES})</li>
 * <li>Instantiate the {@link GuiceSetup} class specified in {@link GuiceProperties#SETUP_PROPERTY}</li>
 * <li>Hand over the GuiceSetup, Roles, Configuration and Classpath Scanner to {@link #createInjector(GuiceRegistry, *
 * ClassScannerFactory, GuiceConfig, GuiceSetup, List)}</li>
 * </ol>
 *
 * @param registry
 * 		(optional) the GuiceRegistry to expose to the Guice environment
 * @param scannerFactory
 * 		(optional) classpath scanner to use
 * @param configs
 * 		base configurations to use
 * @param roles
 * 		base roles to use
 * @param staticSetup
 * 		(optional) a {@link GuiceSetup} implementation to use instead of loading the class name from a property
 * @param autoLoadProperties
 * 		if true, environment.properties etc. and network configuration will be loaded from disk
 * @param autoLoadRoles
 * 		if true, roles will be loaded using the Service Provider Interface
 * @param classloader
 * 		the classloader to use when loading environment.properties etc.
 *
 * @return
 */
static Injector build(final GuiceRegistry registry, ClassScannerFactory scannerFactory, final List<PropertyFile> configs, final List<GuiceRole> roles, final GuiceSetup staticSetup, final boolean autoLoadProperties, final boolean autoLoadRoles, final ClassLoader classloader) {
    final ServiceLoader<GuiceRole> loader = ServiceLoader.load(GuiceRole.class);
    // Find additional guice roles from jar files using the Service Provider Interface
    if (autoLoadRoles) {
        Iterator<GuiceRole> it = loader.iterator();
        while (it.hasNext()) {
            final GuiceRole role = it.next();
            log.debug("Discovered guice role: " + role);
            roles.add(role);
        }
    }
    // Make sure that the first most basic level of properties is the system environment variables
    configs.add(0, getAllEnvironmentVariables());
    // Allow all GuiceRole implementations to add/remove/reorder configuration sources
    for (GuiceRole role : roles) {
        log.debug("Adding requested guice role: " + role);
        role.adjustConfigurations(configs);
    }
    GuiceConfig properties = new GuiceConfig();
    // Generate a random instance ID for this instance of the guice environment
    final String instanceId = SimpleId.alphanumeric(32);
    // Make the randomly generated instance id available to others
    properties.set(GuiceProperties.INSTANCE_ID, instanceId);
    for (PropertyFile config : configs) properties.setAll(config);
    // Load all the core property files?
    if (autoLoadProperties) {
        applyConfigs(classloader, properties);
    }
    // This is a bit of a hack really, but let's insert the GuiceRole for network config if network config is enabled
    if (hasNetworkConfiguration(properties)) {
        final NetworkConfigGuiceRole role = new NetworkConfigGuiceRole();
        roles.add(role);
    }
    // Read the override configuration property to find the override config file
    // Load the override config file and pass that along too.
    PropertyFile overrideFile = load(properties.get(GuiceProperties.OVERRIDE_FILE_PROPERTY));
    // If there are overrides then rebuild the configuration to reflect it
    if (overrideFile != null) {
        log.debug("Applying overrides: " + overrideFile.getFile());
        properties.setOverrides(overrideFile.toMap());
    }
    // Set up the class scanner factory (if the scanner property is set and one has not been provided)
    if (scannerFactory == null) {
        List<String> packages = properties.getList(GuiceProperties.SCAN_PACKAGES, Collections.emptyList());
        if (packages != null && !packages.isEmpty())
            scannerFactory = new ClassScannerFactory(packages.toArray(new String[packages.size()]));
        else
            throw new IllegalArgumentException("Property " + GuiceProperties.SCAN_PACKAGES + " has not been set!");
    }
    final GuiceSetup setup;
    if (staticSetup == null) {
        // Load the Setup property and load the Setup class
        final Class<? extends GuiceSetup> setupClass = getClass(properties, GuiceSetup.class, GuiceProperties.SETUP_PROPERTY);
        try {
            if (setupClass == null)
                throw new IllegalArgumentException("Could not find a setup class!");
            setup = setupClass.newInstance();
            log.debug("Constructed GuiceSetup: " + setupClass);
        } catch (InstantiationException | IllegalAccessException e) {
            throw new IllegalArgumentException("Error constructing instance of " + setupClass, e);
        }
    } else {
        log.debug("Using static GuiceSetup: " + staticSetup);
        setup = staticSetup;
    }
    return createInjector(registry, scannerFactory, properties, setup, roles);
}
Also used : GuiceConfig(com.peterphi.std.guice.common.serviceprops.composite.GuiceConfig) GuiceSetup(com.peterphi.std.guice.apploader.GuiceSetup) GuiceRole(com.peterphi.std.guice.apploader.GuiceRole) NetworkConfigGuiceRole(com.peterphi.std.guice.common.serviceprops.net.NetworkConfigGuiceRole) PropertyFile(com.peterphi.std.io.PropertyFile) ClassScannerFactory(com.peterphi.std.guice.common.ClassScannerFactory) NetworkConfigGuiceRole(com.peterphi.std.guice.common.serviceprops.net.NetworkConfigGuiceRole)

Example 2 with PropertyFile

use of com.peterphi.std.io.PropertyFile in project stdlib by petergeneric.

the class WebappGuiceRole method getConfig.

private static PropertyFile getConfig(ServletConfig servlet, FilterConfig filter, ServletContext context) {
    PropertyFile props = new PropertyFile();
    if (context != null) {
        final Enumeration<String> names = context.getInitParameterNames();
        while (names.hasMoreElements()) {
            final String name = names.nextElement();
            props.set(name, context.getInitParameter(name));
        }
    }
    if (servlet != null) {
        final Enumeration<String> names = servlet.getInitParameterNames();
        while (names.hasMoreElements()) {
            final String name = names.nextElement();
            props.set(name, servlet.getInitParameter(name));
        }
    }
    if (filter != null) {
        final Enumeration<String> names = filter.getInitParameterNames();
        while (names.hasMoreElements()) {
            final String name = names.nextElement();
            props.set(name, filter.getInitParameter(name));
        }
    }
    return props;
}
Also used : PropertyFile(com.peterphi.std.io.PropertyFile)

Example 3 with PropertyFile

use of com.peterphi.std.io.PropertyFile in project stdlib by petergeneric.

the class ClassManifestLocator method get.

/**
 * Attempt to find the MANIFEST.MF associated with a particular class
 *
 * @param clazz
 * 		The class whose jar/war should be searched for a MANIFEST.MF
 *
 * @return a PropertyFile version of the main manifest attributes if found, otherwise null
 */
public static PropertyFile get(Class<?> clazz) {
    try {
        // If we get a guice-enhanced class then we should go up one level to get the class name from the user's code
        if (clazz.getName().contains("$$EnhancerByGuice$$"))
            clazz = clazz.getSuperclass();
        final String classFileName = clazz.getSimpleName() + ".class";
        final String classFilePathAndName = clazz.getName().replace('.', '/') + ".class";
        URL url = clazz.getResource(classFileName);
        if (log.isTraceEnabled())
            log.trace("getResource(" + classFileName + ") = " + url);
        if (url == null) {
            return null;
        } else {
            String classesUrl = url.toString();
            // Get the classes base
            classesUrl = classesUrl.replace(classFilePathAndName, "");
            // Special-case: classes in a webapp are at /WEB-INF/classes/ rather than /
            if (classesUrl.endsWith("WEB-INF/classes/")) {
                classesUrl = classesUrl.replace("WEB-INF/classes/", "");
            }
            final URL manifestURL = new URL(classesUrl + "META-INF/MANIFEST.MF");
            try {
                final InputStream is = manifestURL.openStream();
                try {
                    final PropertyFile props = new PropertyFile();
                    final Manifest manifest = new Manifest(is);
                    for (Object key : manifest.getMainAttributes().keySet()) {
                        final Object value = manifest.getMainAttributes().get(key);
                        props.set(key.toString(), value.toString());
                    }
                    return props;
                } finally {
                    IOUtils.closeQuietly(is);
                }
            } catch (FileNotFoundException e) {
                log.warn("Could not find: " + manifestURL, e);
                return null;
            }
        }
    } catch (Throwable t) {
        log.warn("Error acquiring MANIFEST.MF for " + clazz, t);
        return null;
    }
}
Also used : InputStream(java.io.InputStream) FileNotFoundException(java.io.FileNotFoundException) PropertyFile(com.peterphi.std.io.PropertyFile) Manifest(java.util.jar.Manifest) URL(java.net.URL)

Example 4 with PropertyFile

use of com.peterphi.std.io.PropertyFile in project stdlib by petergeneric.

the class RestConfigListImpl method save.

@Override
public String save() throws IOException {
    if (overridesFile == null) {
        return "No overrides file present, not saved to disk!";
    } else {
        final Map<String, String> overrides = serviceConfig.getOverrides();
        PropertyFile propertyFile = new PropertyFile(overrides);
        propertyFile.save(new File(overridesFile), null);
        return "Save successful.";
    }
}
Also used : PropertyFile(com.peterphi.std.io.PropertyFile) PropertyFile(com.peterphi.std.io.PropertyFile) File(java.io.File)

Example 5 with PropertyFile

use of com.peterphi.std.io.PropertyFile in project stdlib by petergeneric.

the class GuiceRegistryBuilder method createRegistry.

private static GuiceRegistry createRegistry(GuiceConfig config, TestClass clazz) {
    GuiceRegistry registry = new GuiceRegistry();
    ClassScannerFactory scanner = null;
    GuiceRole[] roles = null;
    if (config != null) {
        if (config.packages().length > 0 || config.classPackages().length > 0) {
            Set<String> packages = new HashSet<>();
            packages.addAll(Arrays.asList(config.packages()));
            for (Class c : config.classPackages()) packages.add(c.getPackage().getName());
            scanner = new ClassScannerFactory(packages.toArray(new String[packages.size()]));
        }
        if (config.role().length > 0) {
            List<GuiceRole> instances = new ArrayList<>();
            for (Class<? extends GuiceRole> role : config.role()) {
                try {
                    instances.add(role.newInstance());
                } catch (Exception e) {
                    throw new IllegalArgumentException("Error instantiating GuiceRole " + role, e);
                }
            }
            roles = instances.toArray(new GuiceRole[instances.size()]);
        }
    }
    GuiceBuilder builder = registry.getBuilder();
    if (scanner != null)
        builder.withScannerFactory(scanner);
    else
        builder.withNoScannerFactory();
    if (config != null && config.config().length > 0)
        builder.withConfig(config.config());
    if (config != null)
        builder.withAutoLoadRoles(config.autoLoadRoles());
    if (roles != null)
        builder.withRole(roles);
    // Add local method config sources
    {
        validateGuiceTestConfigMethods(clazz);
        for (Object src : clazz.getAnnotatedMethodValues(null, TestConfig.class, Object.class)) {
            if (src instanceof Properties)
                builder.withConfig((Properties) src);
            else if (src instanceof PropertyFile)
                builder.withConfig((PropertyFile) src);
        }
    }
    // Add local method module sources
    {
        validateGuiceTestModuleMethods(clazz);
        builder.withRole(new ModuleAddingGuiceRole(clazz.getAnnotatedMethodValues(null, TestModule.class, Module.class)));
    }
    // Auto-detect @Automock annotated fields in the test and create mocks for them
    {
        List<FrameworkField> fields = clazz.getAnnotatedFields(Automock.class);
        if (fields.size() > 0)
            builder.withRole(new ModuleAddingGuiceRole(new AutomockAnnotatedMockModule(clazz.getJavaClass(), fields)));
    }
    // Make sure we set the unit test property so roles are aware they're running in a unit test (e.g. so they don't auto-register REST services)
    {
        PropertyFile props = new PropertyFile();
        props.set(GuiceProperties.UNIT_TEST, "true");
        builder.withConfig(props);
    }
    // Add the Setup class, or if none is specified then add local modules:
    if (config != null && config.setup().length > 0) {
        builder.withSetup(config.setup()[0]);
    } else {
        builder.withSetup(new BasicSetup());
    }
    return registry;
}
Also used : ArrayList(java.util.ArrayList) Properties(java.util.Properties) GuiceProperties(com.peterphi.std.guice.apploader.GuiceProperties) ArrayList(java.util.ArrayList) List(java.util.List) ClassScannerFactory(com.peterphi.std.guice.common.ClassScannerFactory) HashSet(java.util.HashSet) TestConfig(com.peterphi.std.guice.testing.com.peterphi.std.guice.testing.annotations.TestConfig) GuiceBuilder(com.peterphi.std.guice.apploader.impl.GuiceBuilder) GuiceRegistry(com.peterphi.std.guice.apploader.impl.GuiceRegistry) GuiceRole(com.peterphi.std.guice.apploader.GuiceRole) PropertyFile(com.peterphi.std.io.PropertyFile) BasicSetup(com.peterphi.std.guice.apploader.BasicSetup) TestClass(org.junit.runners.model.TestClass) Module(com.google.inject.Module) TestModule(com.peterphi.std.guice.testing.com.peterphi.std.guice.testing.annotations.TestModule) TestModule(com.peterphi.std.guice.testing.com.peterphi.std.guice.testing.annotations.TestModule) Automock(com.peterphi.std.guice.testing.com.peterphi.std.guice.testing.annotations.Automock)

Aggregations

PropertyFile (com.peterphi.std.io.PropertyFile)11 File (java.io.File)3 GuiceProperties (com.peterphi.std.guice.apploader.GuiceProperties)2 GuiceRole (com.peterphi.std.guice.apploader.GuiceRole)2 ClassScannerFactory (com.peterphi.std.guice.common.ClassScannerFactory)2 GuiceConfig (com.peterphi.std.guice.common.serviceprops.composite.GuiceConfig)2 URL (java.net.URL)2 ArrayList (java.util.ArrayList)2 Properties (java.util.Properties)2 MetricRegistry (com.codahale.metrics.MetricRegistry)1 AbstractModule (com.google.inject.AbstractModule)1 Injector (com.google.inject.Injector)1 Module (com.google.inject.Module)1 Provides (com.google.inject.Provides)1 Singleton (com.google.inject.Singleton)1 Matchers (com.google.inject.matcher.Matchers)1 Named (com.google.inject.name.Named)1 BasicSetup (com.peterphi.std.guice.apploader.BasicSetup)1 GuiceSetup (com.peterphi.std.guice.apploader.GuiceSetup)1 GuiceBuilder (com.peterphi.std.guice.apploader.impl.GuiceBuilder)1