/*
* JBoss, a division of Red Hat
* Copyright 2009, Red Hat Middleware, LLC, and individual
* contributors as indicated by the @authors tag. See the
* copyright.txt in the distribution for a full listing of
* individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.gatein.registration;
import org.gatein.common.util.ParameterValidation;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* @author <a href="mailto:chris.laprun@jboss.com">Chris Laprun</a>
* @version $Revision: 10388 $
* @since 2.6
*/
public class RegistrationUtils
{
private static boolean strict = true;
private static final Logger log = LoggerFactory.getLogger(RegistrationUtils.class);
public static void setStrict(boolean strict)
{
RegistrationUtils.strict = strict;
log.debug("Using " + (strict ? "strict" : "lenient") + " Consumer Agent validation mode.");
}
/**
* Per the specification (http://www.oasis-open.org/committees/download.php/18617/wsrp-2.0-spec-pr-01.html#_RegistrationData):
* The consumerAgent value MUST start with "productName.majorVersion.minorVersion" where "productName" identifies the
* product the Consumer installed for its deployment, and majorVersion and minorVersion are vendor-defined
* indications of the version of its product. This string can then contain any additional characters/words the
* product or Consumer wish to supply.
*
* @param consumerAgent
* @throws IllegalArgumentException
* @since 2.6
*/
public static void validateConsumerAgent(final String consumerAgent) throws IllegalArgumentException
{
ParameterValidation.throwIllegalArgExceptionIfNullOrEmpty(consumerAgent, "consumer agent", null);
char periodChar = '.';
String tmp = consumerAgent.trim();
int period = tmp.indexOf(periodChar);
if (period != -1)
{
tmp = tmp.substring(period + 1);
period = tmp.indexOf(periodChar);
if (period != -1)
{
tmp = tmp.substring(period + 1);
if (tmp.length() > 0)
{
return;
}
}
}
String msg = "'" + consumerAgent + "' is not a valid Consumer Agent. Please notify your Consumer provider that it is not WSRP-compliant.";
if (strict)
{
throw new IllegalArgumentException(msg);
}
else
{
log.debug(msg);
}
}
}