Classes in this File | Line Coverage | Branch Coverage | Complexity | ||||
WebWarning |
|
| 1.25;1.25 |
1 | /** | |
2 | * Distribution License: | |
3 | * JSword is free software; you can redistribute it and/or modify it under | |
4 | * the terms of the GNU Lesser General Public License, version 2.1 or later | |
5 | * as published by the Free Software Foundation. This program is distributed | |
6 | * in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even | |
7 | * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | |
8 | * See the GNU Lesser General Public License for more details. | |
9 | * | |
10 | * The License is available on the internet at: | |
11 | * http://www.gnu.org/copyleft/lgpl.html | |
12 | * or by writing to: | |
13 | * Free Software Foundation, Inc. | |
14 | * 59 Temple Place - Suite 330 | |
15 | * Boston, MA 02111-1307, USA | |
16 | * | |
17 | * © CrossWire Bible Society, 2007 - 2016 | |
18 | * | |
19 | */ | |
20 | package org.crosswire.jsword.util; | |
21 | ||
22 | import java.io.IOException; | |
23 | import java.net.URI; | |
24 | ||
25 | import org.crosswire.common.util.CWProject; | |
26 | import org.crosswire.common.util.FileUtil; | |
27 | import org.crosswire.common.util.NetUtil; | |
28 | import org.crosswire.common.util.PropertyMap; | |
29 | import org.crosswire.common.util.ResourceUtil; | |
30 | import org.crosswire.jsword.JSMsg; | |
31 | import org.slf4j.Logger; | |
32 | import org.slf4j.LoggerFactory; | |
33 | ||
34 | /** | |
35 | * Provide a configurable warning that the Internet is going to be accessed. | |
36 | * This is important in places where Internet activity may be monitored and | |
37 | * Christians may be persecuted. | |
38 | * | |
39 | * @see gnu.lgpl.License The GNU Lesser General Public License for details. | |
40 | * @author DM Smith | |
41 | */ | |
42 | public final class WebWarning { | |
43 | /** | |
44 | * This is a utility class, thus it's constructor is private. | |
45 | */ | |
46 | 0 | private WebWarning() { |
47 | try { | |
48 | 0 | PropertyMap props = ResourceUtil.getProperties(getClass().getName()); |
49 | 0 | shown = Boolean.valueOf(props.get(SHOWN_KEY, Boolean.valueOf(DEFAULT_SHOWN).toString())).booleanValue(); |
50 | 0 | } catch (IOException e) { |
51 | 0 | shown = DEFAULT_SHOWN; |
52 | 0 | } |
53 | 0 | } |
54 | ||
55 | /** | |
56 | * All access to WebWarning is through this single instance. | |
57 | * | |
58 | * @return the singleton instance | |
59 | */ | |
60 | public static WebWarning instance() { | |
61 | 0 | return instance; |
62 | } | |
63 | ||
64 | /** | |
65 | * @param newShown | |
66 | * Whether this WebWarning should be shown. | |
67 | */ | |
68 | public void setShown(boolean newShown) { | |
69 | try { | |
70 | 0 | shown = newShown; |
71 | 0 | PropertyMap props = new PropertyMap(); |
72 | 0 | props.put(SHOWN_KEY, Boolean.valueOf(shown).toString()); |
73 | 0 | URI outputURI = CWProject.instance().getWritableURI(getClass().getName(), FileUtil.EXTENSION_PROPERTIES); |
74 | 0 | NetUtil.storeProperties(props, outputURI, "JSword WebWarning"); |
75 | 0 | } catch (IOException ex) { |
76 | 0 | log.error("Failed to save JSword WebWarning", ex); |
77 | 0 | } |
78 | 0 | } |
79 | ||
80 | /** | |
81 | * @return Whether this WebWarning should be shown. | |
82 | */ | |
83 | public boolean isShown() { | |
84 | 0 | return shown; |
85 | } | |
86 | ||
87 | /** | |
88 | * From configuration set the state. | |
89 | * | |
90 | * @param newShown | |
91 | * Whether this WebWarning should be shown. | |
92 | */ | |
93 | public static void setWarningShown(boolean newShown) { | |
94 | 0 | WebWarning.instance().setShown(newShown); |
95 | 0 | } |
96 | ||
97 | /** | |
98 | * @return Whether this WebWarning should be shown. | |
99 | */ | |
100 | public static boolean isWarningShown() { | |
101 | 0 | return WebWarning.instance().isShown(); |
102 | } | |
103 | ||
104 | /** | |
105 | * @return a warning that the Internet is about to be accessed | |
106 | */ | |
107 | public String getWarning() { | |
108 | // TRANSLATOR: Warn the user that the program is about to access the Internet. | |
109 | // In some countries, this warning may be too bland. It might be better to warn the user that this might | |
110 | // put them at risk of persecution. | |
111 | 0 | return JSMsg.gettext("You are about to access the Internet. Are you sure you want to do this?"); |
112 | } | |
113 | ||
114 | /** | |
115 | * @return indicate that the warning will be shown again | |
116 | */ | |
117 | public String getShownWarningLabel() { | |
118 | // TRANSLATOR: This labels a checkbox, which is checked by default. | |
119 | // Unchecking it allows the user to not see the message again but the Internet will be accessed. | |
120 | 0 | return JSMsg.gettext("Show this warning every time the Internet is accessed."); |
121 | } | |
122 | ||
123 | 0 | private static WebWarning instance = new WebWarning(); |
124 | ||
125 | private static final String SHOWN_KEY = "shown"; | |
126 | private static final boolean DEFAULT_SHOWN = true; | |
127 | private boolean shown; | |
128 | ||
129 | /** | |
130 | * The log stream | |
131 | */ | |
132 | 0 | private static final Logger log = LoggerFactory.getLogger(WebWarning.class); |
133 | } |