Subversion Repositories XServices

Rev

Rev 83 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 83 Rev 177
1
/*
1
/*
2
 *   Copyright 2010 Brian Rosenberger (Brutex Network)
2
g *   Copyright 2010 Brian Rosenberger (Brutex Network)
3
 *
3
 *
4
 *   Licensed under the Apache License, Version 2.0 (the "License");
4
 *   Licensed under the Apache License, Version 2.0 (the "License");
5
 *   you may not use this file except in compliance with the License.
5
 *   you may not use this file except in compliance with the License.
6
 *   You may obtain a copy of the License at
6
 *   You may obtain a copy of the License at
7
 *
7
 *
8
 *       http://www.apache.org/licenses/LICENSE-2.0
8
 *       http://www.apache.org/licenses/LICENSE-2.0
9
 *
9
 *
10
 *   Unless required by applicable law or agreed to in writing, software
10
 *   Unless required by applicable law or agreed to in writing, software
11
 *   distributed under the License is distributed on an "AS IS" BASIS,
11
 *   distributed under the License is distributed on an "AS IS" BASIS,
12
 *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
 *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
 *   See the License for the specific language governing permissions and
13
 *   See the License for the specific language governing permissions and
14
 *   limitations under the License.
14
 *   limitations under the License.
15
 */
15
 */
16
package net.brutex.xservices.ws;
16
package net.brutex.xservices.ws;
17
 
17
 
18
import javax.jws.WebMethod;
18
import javax.jws.WebMethod;
19
import javax.jws.WebParam;
19
import javax.jws.WebParam;
20
import javax.jws.WebService;
20
import javax.jws.WebService;
21
import net.brutex.xservices.types.CompressionType;
21
import net.brutex.xservices.types.CompressionType;
22
 
22
 
23
import net.brutex.xservices.types.ReturnCode;
23
import net.brutex.xservices.types.ReturnCode;
24
import net.brutex.xservices.types.ant.ArchiveResource;
24
import net.brutex.xservices.types.ant.ArchiveResource;
25
import net.brutex.xservices.types.ant.FileResource;
25
import net.brutex.xservices.types.ant.FileResource;
26
import net.brutex.xservices.types.ant.FileSetResource;
26
import net.brutex.xservices.types.ant.FileSetResource;
27
import net.brutex.xservices.util.BrutexNamespaces;
27
import net.brutex.xservices.util.BrutexNamespaces;
28
 
28
 
29
 
29
 
30
/**
30
/**
31
 * Archiving related web service.
31
 * Archiving related web service.
32
 * 
32
 * 
33
 * @author Brian Rosenberger, bru@brutex.de
33
 * @author Brian Rosenberger, bru@brutex.de
34
 * @since 0.4.0
34
 * @since 0.4.0
35
 */
35
 */
36
@WebService(targetNamespace = BrutexNamespaces.WS_XSERVICES)
36
@WebService(targetNamespace = BrutexNamespaces.WS_XSERVICES)
37
public interface ArchiveService {
37
public interface ArchiveService {
38
 
38
 
39
    final String WS_OPERATION_BZIP2 = "bzip2";
39
    final String WS_OPERATION_BZIP2 = "bzip2";
40
    final String WS_OPERATION_BZIP2_ARCHIVE = "bzip2FromArchive";
40
    final String WS_OPERATION_BZIP2_ARCHIVE = "bzip2FromArchive";
41
    final String WS_OPERATION_GZIP = "gzip";
41
    final String WS_OPERATION_GZIP = "gzip";
42
    final String WS_OPERATION_GZIP_ARCHIVE = "gzipFromArchive";
42
    final String WS_OPERATION_GZIP_ARCHIVE = "gzipFromArchive";
43
    final String WS_OPERATION_UNZIP = "unzip";
43
    final String WS_OPERATION_UNZIP = "unzip";
44
    final String WS_OPERATION_GUNZIP = "gunzip";
44
    final String WS_OPERATION_GUNZIP = "gunzip";
45
    final String WS_OPERATION_BUNZIP2 = "bunzip2";
45
    final String WS_OPERATION_BUNZIP2 = "bunzip2";
46
    final String WS_PARAM_SOURCEFILE = "source";
46
    final String WS_PARAM_SOURCEFILE = "source";
47
    final String WS_PARAM_SOURCEFILE_STRING = "srcfile";
47
    final String WS_PARAM_SOURCEFILE_STRING = "srcfile";
48
    final String WS_PARAM_SOURCEURL = "srcurl";
48
    final String WS_PARAM_SOURCEURL = "srcurl";
49
    final String WS_PARAM_SOURCEARCHIVE = "archivesource";
49
    final String WS_PARAM_SOURCEARCHIVE = "archivesource";
50
    final String WS_PARAM_DESTFILE = "destfile";
50
    final String WS_PARAM_DESTFILE = "destfile";
51
    final String WS_PARAM_DESTDIR = "destdir";
51
    final String WS_PARAM_DESTDIR = "destdir";
52
    final String WS_PARAM_ENCODING = "encoding";
52
    final String WS_PARAM_ENCODING = "encoding";
53
    final String WS_PARAM_OVERWRITE = "overwrite";
53
    final String WS_PARAM_OVERWRITE = "overwrite";
54
    final String WS_PARAM_COMPRESS = "compresslevel";
54
    final String WS_PARAM_COMPRESS = "compresslevel";
55
 
55
 
56
    /**
56
    /**
57
     * @param src
57
     * @param src
58
     * @param file
58
     * @param file
59
     * @return
59
     * @return
60
     * @throws XServicesFault 
60
     * @throws XServicesFault 
61
     */
61
     */
62
    @WebMethod(operationName = WS_OPERATION_BZIP2, action = WS_OPERATION_BZIP2)
62
    @WebMethod(operationName = WS_OPERATION_BZIP2, action = WS_OPERATION_BZIP2)
63
    public ReturnCode bzip2(@WebParam(name = WS_PARAM_SOURCEFILE) FileResource src,
63
    public ReturnCode bzip2(@WebParam(name = WS_PARAM_SOURCEFILE) FileResource src,
64
            @WebParam(name = WS_PARAM_DESTFILE) String file) throws XServicesFault;
64
            @WebParam(name = WS_PARAM_DESTFILE) String file) throws XServicesFault;
65
 
65
 
66
    /**
66
    /**
67
     * @param src
67
     * @param src
68
     * @param file
68
     * @param file
69
     * @return
69
     * @return
70
     * @throws XServicesFault 
70
     * @throws XServicesFault 
71
     */
71
     */
72
    @WebMethod(operationName = WS_OPERATION_BZIP2_ARCHIVE, action = WS_OPERATION_BZIP2_ARCHIVE)
72
    @WebMethod(operationName = WS_OPERATION_BZIP2_ARCHIVE, action = WS_OPERATION_BZIP2_ARCHIVE)
73
    public ReturnCode bzip2FromArchive(@WebParam(name = WS_PARAM_SOURCEARCHIVE) ArchiveResource src,
73
    public ReturnCode bzip2FromArchive(@WebParam(name = WS_PARAM_SOURCEARCHIVE) ArchiveResource src,
74
            @WebParam(name = WS_PARAM_DESTFILE) String file) throws XServicesFault;
74
            @WebParam(name = WS_PARAM_DESTFILE) String file) throws XServicesFault;
75
 
75
 
76
    /**
76
    /**
77
     * @param src
77
     * @param src
78
     * @param file
78
     * @param file
79
     * @return
79
     * @return
80
     * @throws XServicesFault 
80
     * @throws XServicesFault 
81
     */
81
     */
82
    @WebMethod(operationName = WS_OPERATION_GZIP, action = WS_OPERATION_GZIP)
82
    @WebMethod(operationName = WS_OPERATION_GZIP, action = WS_OPERATION_GZIP)
83
    public ReturnCode gzip(@WebParam(name = WS_PARAM_SOURCEFILE) FileResource src,
83
    public ReturnCode gzip(@WebParam(name = WS_PARAM_SOURCEFILE) FileResource src,
84
            @WebParam(name = WS_PARAM_DESTFILE) String file) throws XServicesFault;
84
            @WebParam(name = WS_PARAM_DESTFILE) String file) throws XServicesFault;
85
 
85
 
86
    /**
86
    /**
87
     * @param src
87
     * @param src
88
     * @param file
88
     * @param file
89
     * @return
89
     * @return
90
     * @throws XServicesFault 
90
     * @throws XServicesFault 
91
     */
91
     */
92
    @WebMethod(operationName = WS_OPERATION_GZIP_ARCHIVE, action = WS_OPERATION_GZIP_ARCHIVE)
92
    @WebMethod(operationName = WS_OPERATION_GZIP_ARCHIVE, action = WS_OPERATION_GZIP_ARCHIVE)
93
    public ReturnCode gzipFromArchive(@WebParam(name = WS_PARAM_SOURCEARCHIVE) ArchiveResource src,
93
    public ReturnCode gzipFromArchive(@WebParam(name = WS_PARAM_SOURCEARCHIVE) ArchiveResource src,
94
            @WebParam(name = WS_PARAM_DESTFILE) String file) throws XServicesFault;
94
            @WebParam(name = WS_PARAM_DESTFILE) String file) throws XServicesFault;
95
 
95
 
96
    /**
96
    /**
97
     * @param src
97
     * @param src
98
     * @param dest
98
     * @param dest
99
     * @return
99
     * @return
100
     * @throws XServicesFault 
100
     * @throws XServicesFault 
101
     */
101
     */
102
    @WebMethod(operationName = WS_OPERATION_GUNZIP, action = WS_OPERATION_GUNZIP)
102
    @WebMethod(operationName = WS_OPERATION_GUNZIP, action = WS_OPERATION_GUNZIP)
103
    public ReturnCode gunzip(@WebParam(name = WS_PARAM_SOURCEFILE_STRING) String src,
103
    public ReturnCode gunzip(@WebParam(name = WS_PARAM_SOURCEFILE_STRING) String src,
104
            @WebParam(name = WS_PARAM_DESTDIR) String dest) throws XServicesFault;
104
            @WebParam(name = WS_PARAM_DESTDIR) String dest) throws XServicesFault;
105
 
105
 
106
    /**
106
    /**
107
     * @param src
107
     * @param src
108
     * @param dest
108
     * @param dest
109
     * @return
109
     * @return
110
     * @throws XServicesFault 
110
     * @throws XServicesFault 
111
     */
111
     */
112
    @WebMethod(operationName = WS_OPERATION_BUNZIP2)
112
    @WebMethod(operationName = WS_OPERATION_BUNZIP2)
113
    public ReturnCode bunzip2(@WebParam(name = WS_PARAM_SOURCEFILE_STRING) String src,
113
    public ReturnCode bunzip2(@WebParam(name = WS_PARAM_SOURCEFILE_STRING) String src,
114
            @WebParam(name = WS_PARAM_DESTDIR) String dest) throws XServicesFault;
114
            @WebParam(name = WS_PARAM_DESTDIR) String dest) throws XServicesFault;
115
 
115
 
116
    /**
116
    /**
117
     * @param src
117
     * @param src
118
     * @param dest
118
     * @param dest
119
     * @return
119
     * @return
120
     * @throws XServicesFault 
120
     * @throws XServicesFault 
121
     */
121
     */
122
    @WebMethod(operationName = "gunzipFromURL")
122
    @WebMethod(operationName = "gunzipFromURL")
123
    public ReturnCode gunzipFromURL(@WebParam(name = WS_PARAM_SOURCEURL) String src,
123
    public ReturnCode gunzipFromURL(@WebParam(name = WS_PARAM_SOURCEURL) String src,
124
            @WebParam(name = WS_PARAM_DESTDIR) String dest) throws XServicesFault;
124
            @WebParam(name = WS_PARAM_DESTDIR) String dest) throws XServicesFault;
125
 
125
 
126
    /**
126
    /**
127
     * @param src
127
     * @param src
128
     * @param dest
128
     * @param dest
129
     * @return
129
     * @return
130
     * @throws XServicesFault 
130
     * @throws XServicesFault 
131
     */
131
     */
132
    @WebMethod(operationName = "bunzip2FromURL")
132
    @WebMethod(operationName = "bunzip2FromURL")
133
    public ReturnCode bunzip2FromURL(@WebParam(name = WS_PARAM_SOURCEURL) String src,
133
    public ReturnCode bunzip2FromURL(@WebParam(name = WS_PARAM_SOURCEURL) String src,
134
            @WebParam(name = WS_PARAM_DESTDIR) String dest) throws XServicesFault;
134
            @WebParam(name = WS_PARAM_DESTDIR) String dest) throws XServicesFault;
135
 
135
 
136
    /**
136
    /**
137
     * @param src
137
     * @param src
138
     * @param file
138
     * @param file
139
     * @param overwrite
139
     * @param overwrite
140
     * @param encoding
140
     * @param encoding
141
     * @param level
141
     * @param level
142
     * @return
142
     * @return
143
     * @throws XServicesFault 
143
     * @throws XServicesFault 
144
     */
144
     */
145
    @WebMethod(operationName = "zip")
145
    @WebMethod(operationName = "zip")
146
    public ReturnCode zip(@WebParam(name = WS_PARAM_SOURCEFILE) FileResource src,
146
    public ReturnCode zip(@WebParam(name = WS_PARAM_SOURCEFILE) FileResource src,
147
            @WebParam(name = WS_PARAM_DESTFILE) String file,
147
            @WebParam(name = WS_PARAM_DESTFILE) String file,
148
            @WebParam(name = WS_PARAM_OVERWRITE) boolean overwrite,
148
            @WebParam(name = WS_PARAM_OVERWRITE) boolean overwrite,
149
            @WebParam(name = WS_PARAM_ENCODING) String encoding,
149
            @WebParam(name = WS_PARAM_ENCODING) String encoding,
150
            @WebParam(name = WS_PARAM_COMPRESS) int level) throws XServicesFault;
150
            @WebParam(name = WS_PARAM_COMPRESS) int level) throws XServicesFault;
151
 
151
 
152
    /**
152
    /**
153
     * @param src
153
     * @param src
154
     * @param file
154
     * @param file
155
     * @param update
155
     * @param update
156
     * @param encoding
156
     * @param encoding
157
     * @param level
157
     * @param level
158
     * @return
158
     * @return
159
     * @throws XServicesFault 
159
     * @throws XServicesFault 
160
     */
160
     */
161
    @WebMethod(operationName = "zipFromArchive")
161
    @WebMethod(operationName = "zipFromArchive")
162
    public ReturnCode zipFromArchive(@WebParam(name = WS_PARAM_SOURCEARCHIVE) ArchiveResource src,
162
    public ReturnCode zipFromArchive(@WebParam(name = WS_PARAM_SOURCEARCHIVE) ArchiveResource src,
163
            @WebParam(name = WS_PARAM_DESTFILE) String file,
163
            @WebParam(name = WS_PARAM_DESTFILE) String file,
164
            @WebParam(name = WS_PARAM_OVERWRITE) boolean update,
164
            @WebParam(name = WS_PARAM_OVERWRITE) boolean update,
165
            @WebParam(name = WS_PARAM_ENCODING) String encoding,
165
            @WebParam(name = WS_PARAM_ENCODING) String encoding,
166
            @WebParam(name = "compresslevel") int level) throws XServicesFault;
166
            @WebParam(name = "compresslevel") int level) throws XServicesFault;
167
 
167
 
168
    /**
168
    /**
169
     * @param src
169
     * @param src
170
     * @param dest
170
     * @param dest
171
     * @param overwrite
171
     * @param overwrite
172
     * @param encoding
172
     * @param encoding
173
     * @return
173
     * @return
174
     * @throws XServicesFault 
174
     * @throws XServicesFault 
175
     */
175
     */
176
    @WebMethod(operationName = "unzip")
176
    @WebMethod(operationName = "unzip")
177
    public ReturnCode unzip(@WebParam(name = WS_PARAM_SOURCEFILE_STRING) String src,
177
    public ReturnCode unzip(@WebParam(name = WS_PARAM_SOURCEFILE_STRING) String src,
178
            @WebParam(name = WS_PARAM_DESTDIR) String dest,
178
            @WebParam(name = WS_PARAM_DESTDIR) String dest,
179
            @WebParam(name = WS_PARAM_OVERWRITE) boolean overwrite,
179
            @WebParam(name = WS_PARAM_OVERWRITE) boolean overwrite,
180
            @WebParam(name = WS_PARAM_ENCODING) String encoding) throws XServicesFault;
180
            @WebParam(name = WS_PARAM_ENCODING) String encoding) throws XServicesFault;
181
 
181
 
182
    /**
182
    /**
183
     * @param src
183
     * @param src
184
     * @param dest
184
     * @param dest
185
     * @return
185
     * @return
186
     * @throws XServicesFault 
186
     * @throws XServicesFault 
187
     */
187
     */
188
    @WebMethod(operationName = "unrar")
188
    @WebMethod(operationName = "unrar")
189
    public ReturnCode unrar(@WebParam(name = WS_PARAM_SOURCEFILE_STRING) String src,
189
    public ReturnCode unrar(@WebParam(name = WS_PARAM_SOURCEFILE_STRING) String src,
190
            @WebParam(name = WS_PARAM_DESTDIR) String dest) throws XServicesFault;
190
            @WebParam(name = WS_PARAM_DESTDIR) String dest) throws XServicesFault;
191
 
191
 
192
    /**
192
    /**
193
     * @param src
193
     * @param src
194
     * @param dest
194
     * @param dest
195
     * @param overwrite
195
     * @param overwrite
196
     * @param compression
196
     * @param compression
197
     * @return
197
     * @return
198
     * @throws XServicesFault 
198
     * @throws XServicesFault 
199
     */
199
     */
200
    @WebMethod(operationName = "untar")
200
    @WebMethod(operationName = "untar")
201
    public ReturnCode untar(@WebParam(name = WS_PARAM_SOURCEFILE_STRING) String src,
201
    public ReturnCode untar(@WebParam(name = WS_PARAM_SOURCEFILE_STRING) String src,
202
            @WebParam(name = WS_PARAM_DESTDIR) String dest,
202
            @WebParam(name = WS_PARAM_DESTDIR) String dest,
203
            @WebParam(name = WS_PARAM_OVERWRITE) boolean overwrite,
203
            @WebParam(name = WS_PARAM_OVERWRITE) boolean overwrite,
204
            @WebParam(name = "compression") CompressionType compression) throws XServicesFault;
204
            @WebParam(name = "compression") CompressionType compression) throws XServicesFault;
205
}
205
}