d1863288c54dabd8dfe4f0bb5b59f9356397db8b
[fanfix.git] / Backend.java
1 /*
2 * Jexer - Java Text User Interface
3 *
4 * The MIT License (MIT)
5 *
6 * Copyright (C) 2017 Kevin Lamonte
7 *
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the "Software"),
10 * to deal in the Software without restriction, including without limitation
11 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12 * and/or sell copies of the Software, and to permit persons to whom the
13 * Software is furnished to do so, subject to the following conditions:
14 *
15 * The above copyright notice and this permission notice shall be included in
16 * all copies or substantial portions of the Software.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
23 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
24 * DEALINGS IN THE SOFTWARE.
25 *
26 * @author Kevin Lamonte [kevin.lamonte@gmail.com]
27 * @version 1
28 */
29 package jexer.backend;
30
31 import java.util.List;
32
33 import jexer.event.TInputEvent;
34
35 /**
36 * This interface provides a screen, keyboard, and mouse to TApplication. It
37 * also exposes session information as gleaned from lower levels of the
38 * communication stack.
39 */
40 public interface Backend {
41
42 /**
43 * Get a SessionInfo, which exposes text width/height, language,
44 * username, and other information from the communication stack.
45 *
46 * @return the SessionInfo
47 */
48 public SessionInfo getSessionInfo();
49
50 /**
51 * Get a Screen, which displays the text cells to the user.
52 *
53 * @return the Screen
54 */
55 public Screen getScreen();
56
57 /**
58 * Classes must provide an implementation that syncs the logical screen
59 * to the physical device.
60 */
61 public void flushScreen();
62
63 /**
64 * Classes must provide an implementation to get keyboard, mouse, and
65 * screen resize events.
66 *
67 * @param queue list to append new events to
68 */
69 public void getEvents(List<TInputEvent> queue);
70
71 /**
72 * Classes must provide an implementation that closes sockets, restores
73 * console, etc.
74 */
75 public void shutdown();
76
77 /**
78 * Classes must provide an implementation that sets the window title.
79 *
80 * @param title the new title
81 */
82 public void setTitle(final String title);
83
84 /**
85 * Set listener to a different Object.
86 *
87 * @param listener the new listening object that run() wakes up on new
88 * input
89 */
90 public void setListener(final Object listener);
91
92 }