2 * jSite2 - PersistentGet.java -
3 * Copyright © 2008 David Roden
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
20 package net.pterodactylus.fcp;
23 * The “PersistentGet” message is sent to the client to inform it about a
24 * persistent download, either in the client-local queue or in the global queue.
26 * @author David ‘Bombe’ Roden <bombe@freenetproject.org>
28 public class PersistentGet extends BaseMessage {
31 * Creates a new “PersistentGet” message that wraps the received message.
33 * @param receivedMessage
34 * The received message
36 PersistentGet(FcpMessage receivedMessage) {
37 super(receivedMessage);
41 * Returns the identifier of the request.
43 * @return The identifier of the request
45 public String getIdentifier() {
46 return getField("Identifier");
50 * Returns the URI of the request.
52 * @return The URI of the request
54 public String getURI() {
55 return getField("URI");
59 * Returns the verbosity of the request.
61 * @return The verbosity of the request
63 public Verbosity getVerbosity() {
64 return Verbosity.valueOf(getField("Verbosity"));
68 * Returns the return type of the request.
70 * @return The return type of the request
72 public ReturnType getReturnType() {
74 return ReturnType.valueOf(getField("ReturnType"));
75 } catch (IllegalArgumentException iae1) {
76 return ReturnType.unknown;
81 * Returns the name of the file the data is downloaded to. This field will
82 * only be set if {@link #getReturnType()} is {@link ReturnType#disk}.
84 * @return The name of the file the data is downloaded to
86 public String getFilename() {
87 return getField("Filename");
91 * Returns the name of the temporary file. This field will only be set if
92 * {@link #getReturnType()} is {@link ReturnType#disk}.
94 * @return The name of the temporary file
96 public String getTempFilename() {
97 return getField("TempFilename");
101 * Returns the client token of the request.
103 * @return The client token of the request
105 public String getClientToken() {
106 return getField("ClientToken");
110 * Returns the priority of the request.
112 * @return The priority of the request
114 public Priority getPriority() {
115 return Priority.values()[FcpUtils.safeParseInt(getField("PriorityClass"), Priority.unknown.ordinal())];
119 * Returns the persistence of the request.
121 * @return The persistence of the request, or {@link Persistence#unknown} if
122 * the persistence could not be parsed
124 public Persistence getPersistence() {
126 return Persistence.valueOf(getField("Persistence"));
127 } catch (IllegalArgumentException iae1) {
128 return Persistence.unknown;
133 * Returns whether this request is on the global queue or on the
134 * client-local queue.
136 * @return <code>true</code> if the request is on the global queue,
137 * <code>false</code> if the request is on the client-local queue
139 public boolean isGlobal() {
140 return Boolean.valueOf(getField("Global"));
144 * Returns the maximum number of retries for a failed block.
146 * @return The maximum number of retries for a failed block, <code>-1</code>
147 * for endless retries, <code>-2</code> if the number could not be
150 public int getMaxRetries() {
151 return FcpUtils.safeParseInt(getField("MaxRetries"), -2);