com.phloc.css.propertyvalue.CSSValue Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of phloc-css-jdk5 Show documentation
Show all versions of phloc-css-jdk5 Show documentation
phloc CSS parser an other components
/**
* Copyright (C) 2006-2014 phloc systems
* http://www.phloc.com
* office[at]phloc[dot]com
*
* 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 com.phloc.css.propertyvalue;
import javax.annotation.Nonnegative;
import javax.annotation.Nonnull;
import javax.annotation.concurrent.NotThreadSafe;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import com.phloc.commons.ValueEnforcer;
import com.phloc.commons.hash.HashCodeGenerator;
import com.phloc.commons.string.StringHelper;
import com.phloc.commons.string.ToStringGenerator;
import com.phloc.css.CCSS;
import com.phloc.css.ICSSWriterSettings;
import com.phloc.css.property.ECSSProperty;
import com.phloc.css.property.ICSSProperty;
/**
* Represents the combination of a single CSS property ({@link ICSSProperty})
* and it's according value plus the important state (!important or
* not). The main purpose of this class to make building a CSS from scratch
* simpler. When an existing CSS is read the information resides in a
* {@link com.phloc.css.decl.CSSDeclaration} because it contains the declaration
* value in a more structured form.
* Instances of this class are mutable since 3.7.3.
*
* @author Philip Helger
*/
@NotThreadSafe
public class CSSValue implements ICSSValue
{
private static final Logger s_aLogger = LoggerFactory.getLogger (CSSValue.class);
private ICSSProperty m_aProperty;
private String m_sValue;
private boolean m_bIsImportant;
/**
* Constructor
*
* @param aProperty
* The CSS property. May not be null.
* @param sValue
* The String value to use. May be null. The value may
* NOT contain the !important flag! The
* value is internally trimmed to avoid leading and trailing.
* @param bIsImportant
* true if the value should be important,
* false otherwise
*/
public CSSValue (@Nonnull final ICSSProperty aProperty, @Nonnull final String sValue, final boolean bIsImportant)
{
setProperty (aProperty);
setValue (sValue);
setImportant (bIsImportant);
}
/**
* @return The CSS property used. Never null.
*/
@Nonnull
public ICSSProperty getProperty ()
{
return m_aProperty;
}
/**
* @return The CSS base property used. Never null.
*/
@Nonnull
public ECSSProperty getProp ()
{
return m_aProperty.getProp ();
}
/**
* Set the property of this CSS value (e.g. background-color).
*
* @param aProperty
* The CSS property to set. May not be null.
* @return this
* @since 3.7.3
*/
@Nonnull
public CSSValue setProperty (@Nonnull final ICSSProperty aProperty)
{
m_aProperty = ValueEnforcer.notNull (aProperty, "Property");
return this;
}
/**
* @return The CSS value used. May not be null but maybe empty.
*/
@Nonnull
public String getValue ()
{
return m_sValue;
}
/**
* Set the value of this CSS value (e.g. red in case the property
* is background-color).
*
* @param sValue
* The value to be set. May not be null. The value may
* NOT contain the !important flag! The
* value is internally trimmed to avoid leading and trailing.
* @return this
* @since 3.7.3
*/
@Nonnull
public CSSValue setValue (@Nonnull final String sValue)
{
ValueEnforcer.notNull (sValue, "Value");
if (!m_aProperty.isValidValue (sValue))
s_aLogger.warn ("CSS: the value '" +
sValue +
"' is not valid for property '" +
m_aProperty.getProp ().getName () +
"'");
if (sValue.contains (CCSS.IMPORTANT_SUFFIX))
s_aLogger.warn ("CSS: the value '" +
sValue +
"' should not contain the '" +
CCSS.IMPORTANT_SUFFIX +
"' string! Use 'setImportant' method instead.");
m_sValue = sValue.trim ();
return this;
}
/**
* @return true if it is important, false if not
*/
public boolean isImportant ()
{
return m_bIsImportant;
}
/**
* Set the important flag of this value.
*
* @param bIsImportant
* true to mark it important, false to remove
* it.
* @return this
* @since 3.7.3
*/
@Nonnull
public CSSValue setImportant (final boolean bIsImportant)
{
m_bIsImportant = bIsImportant;
return this;
}
@Nonnull
public String getAsCSSString (@Nonnull final ICSSWriterSettings aSettings, @Nonnegative final int nIndentLevel)
{
aSettings.checkVersionRequirements (m_aProperty);
return m_aProperty.getProp ().getName () +
CCSS.SEPARATOR_PROPERTY_VALUE +
m_sValue +
(StringHelper.hasText (m_sValue) && m_bIsImportant ? CCSS.IMPORTANT_SUFFIX : "") +
CCSS.DEFINITION_END;
}
@Override
public boolean equals (final Object o)
{
if (o == this)
return true;
if (o == null || !getClass ().equals (o.getClass ()))
return false;
final CSSValue rhs = (CSSValue) o;
// Important flag is contained in the value!
return m_aProperty.getProp ().equals (rhs.m_aProperty.getProp ()) &&
m_sValue.equals (rhs.m_sValue) &&
m_bIsImportant == rhs.m_bIsImportant;
}
@Override
public int hashCode ()
{
return new HashCodeGenerator (this).append (m_aProperty.getProp ())
.append (m_sValue)
.append (m_bIsImportant)
.getHashCode ();
}
@Override
public String toString ()
{
return new ToStringGenerator (this).append ("property", m_aProperty)
.append ("value", m_sValue)
.append ("important", m_bIsImportant)
.toString ();
}
}