001package com.github.theholywaffle.teamspeak3.commands; 002 003/* 004 * #%L 005 * TeamSpeak 3 Java API 006 * %% 007 * Copyright (C) 2017 Bert De Geyter, Roger Baumgartner 008 * %% 009 * Permission is hereby granted, free of charge, to any person obtaining a copy 010 * of this software and associated documentation files (the "Software"), to deal 011 * in the Software without restriction, including without limitation the rights 012 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 013 * copies of the Software, and to permit persons to whom the Software is 014 * furnished to do so, subject to the following conditions: 015 * 016 * The above copyright notice and this permission notice shall be included in 017 * all copies or substantial portions of the Software. 018 * 019 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 020 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 021 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 022 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 023 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 024 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 025 * THE SOFTWARE. 026 * #L% 027 */ 028 029import com.github.theholywaffle.teamspeak3.api.event.TS3EventType; 030import com.github.theholywaffle.teamspeak3.commands.parameter.KeyValueParam; 031import com.github.theholywaffle.teamspeak3.commands.parameter.ValueParam; 032 033public final class QueryCommands { 034 035 private QueryCommands() { 036 throw new Error("No instances"); 037 } 038 039 public static Command logIn(String username, String password) { 040 if (username == null || username.isEmpty()) { 041 throw new IllegalArgumentException("Username must be a non-empty string"); 042 } 043 if (password == null || password.isEmpty()) { 044 throw new IllegalArgumentException("Password must be a non-empty string"); 045 } 046 047 return new CommandBuilder("login", 2).add(new ValueParam(username)).add(new ValueParam(password)).build(); 048 } 049 050 public static Command logOut() { 051 return new CommandBuilder("logout").build(); 052 } 053 054 public static Command quit() { 055 return new CommandBuilder("quit").build(); 056 } 057 058 public static Command serverNotifyRegister(TS3EventType eventType, int channelId) { 059 if (eventType == null) { 060 throw new IllegalArgumentException("Event type cannot be null"); 061 } 062 063 CommandBuilder builder = new CommandBuilder("servernotifyregister", 2); 064 builder.add(new KeyValueParam("event", eventType.toString())); 065 builder.addIf(channelId >= 0, new KeyValueParam("id", channelId)); 066 return builder.build(); 067 } 068 069 public static Command serverNotifyUnregister() { 070 return new CommandBuilder("servernotifyunregister").build(); 071 } 072 073 public static Command useId(int id) { 074 return new CommandBuilder("use", 1).add(new KeyValueParam("sid", id)).build(); 075 } 076 077 public static Command usePort(int port) { 078 return new CommandBuilder("use", 1).add(new KeyValueParam("port", port)).build(); 079 } 080 081 public static Command whoAmI() { 082 return new CommandBuilder("whoami").build(); 083 } 084}