001 /* 002 * Sonar, open source software quality management tool. 003 * Copyright (C) 2009 SonarSource SA 004 * mailto:contact AT sonarsource DOT com 005 * 006 * Sonar is free software; you can redistribute it and/or 007 * modify it under the terms of the GNU Lesser General Public 008 * License as published by the Free Software Foundation; either 009 * version 3 of the License, or (at your option) any later version. 010 * 011 * Sonar is distributed in the hope that it will be useful, 012 * but WITHOUT ANY WARRANTY; without even the implied warranty of 013 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 014 * Lesser General Public License for more details. 015 * 016 * You should have received a copy of the GNU Lesser General Public 017 * License along with Sonar; if not, write to the Free Software 018 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02 019 */ 020 package org.sonar.wsclient.services; 021 022 import java.util.Date; 023 024 public abstract class Query<MODEL extends Model> { 025 026 /** 027 * Must start with a slash, for example: /api/metrics 028 */ 029 public abstract String getUrl(); 030 031 public abstract Class<MODEL> getModelClass(); 032 033 protected static void appendUrlParameter(StringBuilder url, String paramKey, Object paramValue) { 034 if (paramValue != null) { 035 url.append(paramKey) 036 .append('=') 037 .append(paramValue) 038 .append('&'); 039 } 040 } 041 042 protected static void appendUrlParameter(StringBuilder url, String paramKey, Object[] paramValues) { 043 if (paramValues != null) { 044 url.append(paramKey).append('='); 045 for (int index = 0; index < paramValues.length; index++) { 046 if (index > 0) { 047 url.append(','); 048 } 049 if (paramValues[index] != null) { 050 url.append(paramValues[index]); 051 } 052 } 053 url.append('&'); 054 } 055 } 056 057 protected static void appendUrlParameter(StringBuilder url, String paramKey, Date paramValue, boolean includeTime) { 058 if (paramValue != null) { 059 String format = (includeTime ? "yyyy-MM-dd'T'HH:mm:ssZ" : "yyyy-MM-dd"); 060 url.append(paramKey) 061 .append('=') 062 .append(WSUtils.getINSTANCE().encodeUrl(WSUtils.getINSTANCE().format(paramValue, format))) 063 .append('&'); 064 } 065 } 066 }