This repository has been archived by the owner on Apr 4, 2024. It is now read-only.
/
CLPCommandType.java
86 lines (70 loc) · 1.73 KB
/
CLPCommandType.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
/*
* Copyright © 2020 Mark Raynsford <code@io7m.com> http://io7m.com
*
* Permission to use, copy, modify, and/or distribute this software for any
* purpose with or without fee is hereby granted, provided that the above
* copyright notice and this permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
* SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
* IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/
package com.io7m.claypot.core;
import org.osgi.annotation.versioning.ProviderType;
/**
* The base type of commands.
*/
@ProviderType
public interface CLPCommandType
{
/**
* @return Extra help text for the command
*/
default String extendedHelp() {
return "";
}
/**
* @return The name of the command
*/
String name();
/**
* Execute the command.
*
* @return The resulting command status
*
* @throws Exception On errors.
*/
Status execute()
throws Exception;
/**
* The result of executing a command.
*/
enum Status
{
/**
* The command succeeded.
*/
SUCCESS,
/**
* The command failed.
*/
FAILURE;
/**
* @return The shell exit code
*/
public int exitCode()
{
switch (this) {
case SUCCESS:
return 0;
case FAILURE:
return 1;
}
throw new IllegalStateException();
}
}
}