/*******************************************************************************
*
* Copyright (c) 2010, InfraDNA, Inc.
*
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
*
*
*
*
*******************************************************************************/
package hudson.model.labels;
import com.thoughtworks.xstream.converters.MarshallingContext;
import com.thoughtworks.xstream.converters.UnmarshallingContext;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.io.HierarchicalStreamWriter;
import hudson.BulkChange;
import hudson.CopyOnWrite;
import hudson.XmlFile;
import hudson.model.Action;
import hudson.model.Descriptor.FormException;
import hudson.model.Failure;
import hudson.model.Hudson;
import hudson.model.Label;
import hudson.model.Saveable;
import hudson.model.listeners.SaveableListener;
import hudson.util.DescribableList;
import hudson.util.QuotedStringTokenizer;
import hudson.util.VariableResolver;
import hudson.util.XStream2;
import org.kohsuke.stapler.StaplerRequest;
import org.kohsuke.stapler.StaplerResponse;
import org.kohsuke.stapler.export.Exported;
import javax.servlet.ServletException;
import java.io.File;
import java.io.IOException;
import java.util.Collections;
import java.util.List;
import java.util.Vector;
import java.util.logging.Level;
import java.util.logging.Logger;
/**
* Atomic single token label, like "foo" or "bar".
*
* @author Kohsuke Kawaguchi
* @since 1.372
*/
public class LabelAtom extends Label implements Saveable {
private DescribableList<LabelAtomProperty, LabelAtomPropertyDescriptor> properties =
new DescribableList<LabelAtomProperty, LabelAtomPropertyDescriptor>(this);
@CopyOnWrite
protected transient volatile List<Action> transientActions = new Vector<Action>();
public LabelAtom(String name) {
super(name);
}
/**
* If the label contains 'unsafe' chars, escape them.
*/
@Override
public String getExpression() {
return escape(name);
}
/**
* {@inheritDoc}
*
* <p> Note that this method returns a read-only view of {@link Action}s.
* {@link LabelAtomProperty}s who want to add a project action should do so
* by implementing {@link LabelAtomProperty#getActions(LabelAtom)}.
*/
@Override
public synchronized List<Action> getActions() {
// add all the transient actions, too
List<Action> actions = new Vector<Action>(super.getActions());
actions.addAll(transientActions);
// return the read only list to cause a failure on plugins who try to add an action here
return Collections.unmodifiableList(actions);
}
protected void updateTransientActions() {
Vector<Action> ta = new Vector<Action>();
// add the config link
if (!getApplicablePropertyDescriptors().isEmpty()) {
// if there's no property descriptor, there's nothing interesting to configure.
ta.add(new Action() {
public String getIconFileName() {
if (Hudson.getInstance().hasPermission(Hudson.ADMINISTER)) {
return "setting.png";
} else {
return null;
}
}
public String getDisplayName() {
return "Configure";
}
public String getUrlName() {
return "configure";
}
});
}
for (LabelAtomProperty p : properties) {
ta.addAll(p.getActions(this));
}
transientActions = ta;
}
/**
* Properties associated with this label.
*/
public DescribableList<LabelAtomProperty, LabelAtomPropertyDescriptor> getProperties() {
return properties;
}
@Exported
public List<LabelAtomProperty> getPropertiesList() {
return properties.toList();
}
@Override
public boolean matches(VariableResolver<Boolean> resolver) {
return resolver.resolve(name);
}
@Override
public LabelOperatorPrecedence precedence() {
return LabelOperatorPrecedence.ATOM;
}
/*package*/ XmlFile getConfigFile() {
return new XmlFile(XSTREAM, new File(Hudson.getInstance().root, "labels/" + name + ".xml"));
}
public void save() throws IOException {
if (BulkChange.contains(this)) {
return;
}
try {
getConfigFile().write(this);
SaveableListener.fireOnChange(this, getConfigFile());
} catch (IOException e) {
LOGGER.log(Level.WARNING, "Failed to save " + getConfigFile(), e);
}
}
public void load() {
XmlFile file = getConfigFile();
if (file.exists()) {
try {
file.unmarshal(this);
} catch (IOException e) {
LOGGER.log(Level.WARNING, "Failed to load " + file, e);
}
}
properties.setOwner(this);
updateTransientActions();
}
/**
* Returns all the {@link LabelAtomPropertyDescriptor}s that can be
* potentially configured on this label.
*/
public List<LabelAtomPropertyDescriptor> getApplicablePropertyDescriptors() {
return LabelAtomProperty.all();
}
/**
* Accepts the update to the node configuration.
*/
public void doConfigSubmit(StaplerRequest req, StaplerResponse rsp) throws IOException, ServletException, FormException {
final Hudson app = Hudson.getInstance();
app.checkPermission(Hudson.ADMINISTER);
properties.rebuild(req, req.getSubmittedForm(), getApplicablePropertyDescriptors());
updateTransientActions();
save();
// take the user back to the label top page.
rsp.sendRedirect2(".");
}
/**
* Obtains an atom by its {@linkplain #getName() name}.
*/
public static LabelAtom get(String l) {
return Hudson.getInstance().getLabelAtom(l);
}
public static boolean needsEscape(String name) {
try {
Hudson.checkGoodName(name);
// additional restricted chars
for (int i = 0; i < name.length(); i++) {
char ch = name.charAt(i);
if (" ()\t\n".indexOf(ch) != -1) {
return true;
}
}
return false;
} catch (Failure failure) {
return true;
}
}
public static String escape(String name) {
if (needsEscape(name)) {
return QuotedStringTokenizer.quote(name);
}
return name;
}
private static final Logger LOGGER = Logger.getLogger(LabelAtom.class.getName());
private static final XStream2 XSTREAM = new XStream2();
static {
// Don't want Label.ConverterImpl to be used:
XSTREAM.registerConverter(new LabelAtomConverter(), 100);
}
// class name is not ConverterImpl, to avoid getting picked up by AssociatedConverterImpl
private static class LabelAtomConverter extends XStream2.PassthruConverter<LabelAtom> {
private Label.ConverterImpl leafLabelConverter = new Label.ConverterImpl();
private LabelAtomConverter() {
super(XSTREAM);
}
public boolean canConvert(Class type) {
return LabelAtom.class.isAssignableFrom(type);
}
public void marshal(Object source, HierarchicalStreamWriter writer, MarshallingContext context) {
if (context.get(IN_NESTED) == null) {
context.put(IN_NESTED, true);
try {
super.marshal(source, writer, context);
} finally {
context.put(IN_NESTED, false);
}
} else {
leafLabelConverter.marshal(source, writer, context);
}
}
public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
if (context.get(IN_NESTED) == null) {
context.put(IN_NESTED, true);
try {
return super.unmarshal(reader, context);
} finally {
context.put(IN_NESTED, false);
}
} else {
return leafLabelConverter.unmarshal(reader, context);
}
}
@Override
protected void callback(LabelAtom obj, UnmarshallingContext context) {
// noop
}
private static final Object IN_NESTED = "VisitingInnerLabelAtom";
}
}