0c7b4cbd6e7821b1e8f2459ffe4bb7eb926d3108
[rhynodge.git] / src / main / java / net / pterodactylus / rhynodge / states / FileState.java
1 /*
2  * Rhynodge - FileState.java - Copyright © 2013 David Roden
3  *
4  * This program is free software: you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License as published by
6  * the Free Software Foundation, either version 3 of the License, or
7  * (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
16  */
17
18 package net.pterodactylus.rhynodge.states;
19
20 import net.pterodactylus.rhynodge.State;
21
22 /**
23  * A {@link State} that contains information about a file.
24  *
25  * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
26  */
27 public class FileState extends AbstractState {
28
29         /** Whether the file exists. */
30         private final boolean exists;
31
32         /** Whether the file is readable. */
33         private final boolean readable;
34
35         /** The size of the file. */
36         private final long size;
37
38         /** The modification time of the file. */
39         private final long modificationTime;
40
41         /**
42          * Creates a new file state that signals that an exceptio occured during
43          * retrieval.
44          *
45          * @param exception
46          *            The exception that occured
47          */
48         public FileState(Throwable exception) {
49                 super(exception);
50                 exists = false;
51                 readable = false;
52                 size = -1;
53                 modificationTime = -1;
54         }
55
56         /**
57          * Creates a new file state.
58          *
59          * @param exists
60          *            {@code true} if the file exists, {@code false} otherwise
61          * @param readable
62          *            {@code true} if the file is readable, {@code false} otherwise
63          * @param size
64          *            The size of the file (in bytes)
65          * @param modificationTime
66          *            The modification time of the file (in milliseconds since Jan
67          *            1, 1970 UTC)
68          */
69         public FileState(boolean exists, boolean readable, long size, long modificationTime) {
70                 this.exists = exists;
71                 this.readable = readable;
72                 this.size = size;
73                 this.modificationTime = modificationTime;
74         }
75
76         //
77         // ACCESSORS
78         //
79
80         @Override
81         public boolean isEmpty() {
82                 return !exists;
83         }
84
85         /**
86          * Returns whether the file exists.
87          *
88          * @return {@code true} if the file exists, {@code false} otherwise
89          */
90         public boolean exists() {
91                 return exists;
92         }
93
94         /**
95          * Returns whether the file is readable.
96          *
97          * @return {@code true} if the file is readable, {@code false} otherwise
98          */
99         public boolean readable() {
100                 return readable;
101         }
102
103         /**
104          * Returns the size of the file.
105          *
106          * @return The size of the file (in bytes)
107          */
108         public long size() {
109                 return size;
110         }
111
112         /**
113          * Returns the modification time of the file.
114          *
115          * @return The modification time of the file (in milliseconds since Jan 1,
116          *         1970 UTC)
117          */
118         public long modificationTime() {
119                 return modificationTime;
120         }
121
122         //
123         // OBJECT METHODS
124         //
125
126         /**
127          * {@inheritDoc}
128          */
129         @Override
130         public String toString() {
131                 return String.format("%s[exists=%s,readable=%s,size=%s,modificationTime=%d(%5$tc)", getClass().getSimpleName(), exists(), readable(), size(), modificationTime());
132         }
133
134 }