com.marvelution.hudson.plugins.apiv2.client.services.AbstractQuery Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of hudson-apiv2-wsclient Show documentation

This library can be used to connect to the new REST API.

There is a newer version: 5.0.4

Show newest version

/*
 * Licensed to Marvelution under one or more contributor license 
 * agreements.  See the NOTICE file distributed with this work 
 * for additional information regarding copyright ownership.
 * Marvelution licenses this file to you 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.marvelution.hudson.plugins.apiv2.client.services;

import org.apache.commons.codec.EncoderException;

import com.marvelution.hudson.plugins.apiv2.resources.model.Model;

/**
 * Abstract {@link Query} implementation
 * 
 * @author Mark Rekveld
 *
 * @param  the {@link Model} type
 */
public abstract class AbstractQuery implements Query {

	private final Class modelClass;
	private final QueryType type;

	/**
	 * Protected constructor so this class must be subclassed
	 *  
	 * @param modelClass the {@link Class}
	 */
	protected AbstractQuery(Class modelClass, QueryType type) {
		this.modelClass = modelClass;
		this.type = type;
	}

	/**
	 * {@inheritDoc}
	 */
	@Override
	public final QueryType getQueryType() {
		return type;
	}

	/**
	 * {@inheritDoc}
	 */
	@Override
	public final String getUrl() {
		return "/apiv2/" + getSpecificUrl();
	}

	/**
	 * {@inheritDoc}
	 */
	@Override
	public  T getData() {
		// Default implementation for the Queries. Most don't need this as they are GET Queries
		return null;
	}

	/**
	 * {@inheritDoc}
	 */
	@Override
	public Class getModelClass() {
		return modelClass;
	}

	/**
	 * Helper method to url encode a given {@link String}
	 * 
	 * @param url the url {@link String} to encode
	 * @return the encoded url
	 */
	protected String urlEncode(String url) {
		try {
			return URLCODEC.encode(url).replace("+", "%20");
		} catch (EncoderException e) {
			return url;
		}
	}

	/**
	 * Get the specific url
	 *  
	 * @return the specific url, must NOT start with a slash '/'
	 */
	protected abstract String getSpecificUrl();

}