/*
Copyright 2014-now by Alain Stalder. Made in Switzerland.
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 ch.grengine.sources;
import java.util.Set;
import java.util.UUID;
import ch.grengine.code.CompilerFactory;
import ch.grengine.code.groovy.DefaultGroovyCompilerFactory;
import ch.grengine.source.Source;
/**
* Sources based on a fixed set of {@link Source}.
*
* @since 1.0
*
* @author Alain Stalder
* @author Made in Switzerland.
*/
public class FixedSetSources extends BaseSources {
private final Builder builder;
private final Set<Source> sourceSet;
/**
* constructor from builder.
*
* @since 1.0
*/
public FixedSetSources(final Builder builder) {
this.builder = builder.commit();
sourceSet = builder.getSourceSet();
super.init(builder.getName(), builder.getCompilerFactory(), builder.getLatencyMs());
}
@Override
protected Set<Source> getSourceSetNew() {
return sourceSet;
}
/**
* gets the builder.
*
* @since 1.0
*/
public Builder getBuilder() {
return builder;
}
/**
* Builder for instances of {@link FixedSetSources}.
*
* @since 1.0
*
* @author Alain Stalder
* @author Made in Switzerland.
*/
public static class Builder {
/**
* the default latency (5000ms = five seconds).
*
* @since 1.0
*/
public static final long DEFAULT_LATENCY_MS = 5000L;
private boolean isCommitted;
private final Set<Source> sourceSet;
private String name;
private CompilerFactory compilerFactory;
private long latencyMs = -1;
/**
* constructor from fixed source set.
*
* @throws IllegalArgumentException if the source set is null
*
* @since 1.0
*/
public Builder(final Set<Source> sourceSet) {
if (sourceSet == null) {
throw new IllegalArgumentException("Source set is null.");
}
this.sourceSet = sourceSet;
isCommitted = false;
}
/**
* sets the sources name, default is a generated random ID.
*
* @return this, for chaining calls
* @throws IllegalStateException if the builder had already been used to build an instance
*
* @since 1.0
*/
public Builder setName(final String name) {
check();
this.name = name;
return this;
}
/**
* sets the compiler factory for compiling sources, default
* is a new instance of {@link DefaultGroovyCompilerFactory}.
*
* @return this, for chaining calls
* @throws IllegalStateException if the builder had already been used to build an instance
*
* @since 1.0
*/
public Builder setCompilerFactory(final CompilerFactory compilerFactory) {
check();
this.compilerFactory = compilerFactory;
return this;
}
/**
* sets the latency in milliseconds for checking if script files
* in the directory have changed, default is {@link #DEFAULT_LATENCY_MS}.
*
* @return this, for chaining calls
* @throws IllegalStateException if the builder had already been used to build an instance
*
* @since 1.0
*/
public Builder setLatencyMs(long latencyMs) {
check();
this.latencyMs = latencyMs;
return this;
}
/**
* gets the fixed source set.
*
* @since 1.0
*/
public Set<Source> getSourceSet() {
return sourceSet;
}
/**
* gets the sources name.
*
* @since 1.0
*/
public String getName() {
return name;
}
/**
* gets the compiler factory.
*
* @since 1.0
*/
public CompilerFactory getCompilerFactory() {
return compilerFactory;
}
/**
* gets the latency in milliseconds.
*
* @since 1.0
*/
public long getLatencyMs() {
return latencyMs;
}
private Builder commit() {
if (!isCommitted) {
if (name == null) {
name = UUID.randomUUID().toString();
}
if (compilerFactory == null) {
compilerFactory = new DefaultGroovyCompilerFactory();
}
if (latencyMs < 0) {
latencyMs = DEFAULT_LATENCY_MS;
}
isCommitted = true;
}
return this;
}
/**
* builds a new instance of {@link FixedSetSources}.
*
* @since 1.0
*/
public FixedSetSources build() {
commit();
return new FixedSetSources(this);
}
private void check() {
if (isCommitted) {
throw new IllegalStateException("Builder already used.");
}
}
}
}