org.netbeans.modules.externaleditor
Interface ExtEdProtocol
- All Known Implementing Classes:
- ExtEdCaret, ExtEdConnection, ExtEdDocument, ExtEdKit, ExtEdProxier
- public interface ExtEdProtocol
Protocol for communication between external editor and NetBeans.
All messages are in ASCII, with the following syntax:
CMD: proxyID : verb ! seqno [ arg ... ]
FUN: proxyID : verb / seqno [ arg ... ]
EVT: proxyID : verb = seqno [ arg ... ]
REPLY: seqno [ arg ... | err ]
CMDs are sent by NetBeans; no reply is necessary.
FUNs are sent by NetBeans and expect a matching REPLY.
EVTs are sent by the external editor; no reply is necessary.
proxyID is a decimal integer, starting at 1 (0 is reserved for
"global" EVTs); it identifies the particular buffer.
verbs are listed below
seqno is a positive decimal integer that monotonically increases
with each CMD or FUN; REPLY uses the seqno of the corresponding
FUN.
arg may be any of
"string" (literal quotes; newlines, carriage returns, double
quotes, and backslashes encoded as \n \r \" \\, resp.)
T ("true")
F ("false")
[+-]digits (decimal integer)
err is
! "string" (FUN failed; throws an exception containing the string)
Comments below indicate the types of args and results thusly:
TXT quoted, escaped string
BOOL literal T or F
NUM decimal integer with optional sign
OPTNUM either a NUM or the word "none" (no quotes)
Argument/results named "pos", "off", "dot", or "mark" indicate a
zero-based character position in the document.
"pathname" indicates a full pathname, if it's a "real" file, or the full
pathname of the JAR file plus "," and the name of the file in the jar.
Field Summary |
static java.lang.String |
CMD_actionMenuItem
actionMenuItem (name, action, enabled, accel) { TXT, TXT, BOOL, TXT } |
static java.lang.String |
CMD_actionSensitivity
actionSensitivity (action, enabled) { TXT, BOOL } |
static java.lang.String |
CMD_addAnno
addAnno (serial, typeNum, off, len) { NUM, NUM, NUM, NUM } |
static java.lang.String |
CMD_balloonResult
balloonResult (text) { TXT } |
static java.lang.String |
CMD_close
close () |
static java.lang.String |
CMD_create
create () |
static java.lang.String |
CMD_defineAnnoType
defineAnnoType (typeNum, typeName, tooltip, glyphFile, fg, bg) { NUM, TXT, TXT, TXT, OPTNUM, OPTNUM } |
static java.lang.String |
CMD_destroyPosition
|
static java.lang.String |
CMD_enableBalloonEval
enableBalloonEval () |
static java.lang.String |
CMD_endAtomic
endAtomic () |
static java.lang.String |
CMD_guard
|
static java.lang.String |
CMD_ignore
|
static java.lang.String |
CMD_initDone
initDone () |
static java.lang.String |
CMD_moveAnnoToFront
moveAnnoToFront (serial) { NUM } |
static java.lang.String |
CMD_removeAnno
removeAnno (serial) { NUM } |
static java.lang.String |
CMD_setAsUser
setAsUser (asuser) { BOOL } |
static java.lang.String |
CMD_setBufferNumber
setBufferNumber (pathname) { TXT } |
static java.lang.String |
CMD_setContentType
setContentType (type) { TXT } |
static java.lang.String |
CMD_setDot
setDot (off) { NUM } |
static java.lang.String |
CMD_setFullName
setFullName (name) { TXT } |
static java.lang.String |
CMD_setLocAndSize
setLocAndSize (x, y, w, h) { NUM, NUM, NUM, NUM } |
static java.lang.String |
CMD_setMark
setMark (off) { NUM } |
static java.lang.String |
CMD_setModified
setModified (isMod) { BOOL } |
static java.lang.String |
CMD_setReadOnly
setReadOnly (isReadOnly) { BOOL } |
static java.lang.String |
CMD_setTitle
setTitle (title) { TXT } |
static java.lang.String |
CMD_setVisible
setVisible (isVis) { BOOL } |
static java.lang.String |
CMD_specialKeys
specialKeys ( keys ) { TXT } |
static java.lang.String |
CMD_startAtomic
startAtomic () |
static java.lang.String |
CMD_startCaretListen
startCaretListen () |
static java.lang.String |
CMD_startDocumentListen
startDocumentListen () |
static java.lang.String |
CMD_stopCaretListen
stopCaretListen () |
static java.lang.String |
CMD_stopDocumentListen
|
static java.lang.String |
CMD_unguard
|
static java.lang.String |
EVT_balloonEval
balloonEval (pos, length, eval-type) { NUM, NUM, NUM }
values for "eval-type" are currently unspecified and ignored |
static java.lang.String |
EVT_fileClosed
fileClosed (pathname) { TXT } |
static java.lang.String |
EVT_fileModified
fileModified (pathname, flag) { TXT, BOOL } |
static java.lang.String |
EVT_fileOpened
fileOpened (pathname, openInIDE, isModified) { TXT, BOOL, BOOL } |
static java.lang.String |
EVT_geometry
geometry (cols, rows, x, y) { NUM, NUM, NUM, NUM } |
static java.lang.String |
EVT_insert
insert (off, text) { NUM, TXT } |
static java.lang.String |
EVT_invokeAction
invokeAction (actionName) { TXT } |
static java.lang.String |
EVT_keyCommand
keyCommand (name) { TXT }
see Utilities.stringToKey, e.g. |
static java.lang.String |
EVT_killed
killed () |
static java.lang.String |
EVT_newDotAndMark
newDotAndMark (dot, mark) { NUM, NUM } |
static java.lang.String |
EVT_quit
quit ()
tell NetBeans to exit gracefully |
static java.lang.String |
EVT_remove
remove (off, len) { NUM, NUM } ( len = -1 means all text ) |
static java.lang.String |
EVT_revert
revert () |
static java.lang.String |
EVT_save
save () |
static java.lang.String |
EVT_unmodified
unmodified()
buffer became unmodified via UNDOs |
static java.lang.String |
EVT_version
version |
static java.lang.String |
FUN_countLines
|
static java.lang.String |
FUN_createPosition
|
static java.lang.String |
FUN_findLineFromOffset
|
static java.lang.String |
FUN_getDot
getDot () -> (off) { NUM } |
static java.lang.String |
FUN_getLength
getLength () -> (length) { NUM } |
static java.lang.String |
FUN_getLineStartOffset
|
static java.lang.String |
FUN_getMark
getMark () -> (off) { NUM } |
static java.lang.String |
FUN_getText
getText (off, length) -> (text) or (reason, off) { TXT, NUM } |
static java.lang.String |
FUN_insert
insert (off, text) -> () or (reason, off) { TXT, NUM } |
static java.lang.String |
FUN_lookupPosition
|
static java.lang.String |
FUN_remove
remove (off, length) -> () or (reason, off) { TXT, NUM } |
static java.lang.String |
META_ACCEPT
|
static java.lang.String |
META_AUTH
|
static java.lang.String |
META_DISCONNECT
|
static java.lang.String |
META_REJECT
|
static java.lang.String |
PROP_locAndSize
|
static java.lang.String[] |
SERIAL_COMMANDS
|
static java.lang.String[] |
SERIAL_EVENTS
|
static java.lang.String[] |
SERIAL_FUNCTIONS
|
static java.lang.String |
STYLE_BREAKPOINT
|
static java.lang.String |
STYLE_CURRENT
|
static java.lang.String |
STYLE_ERROR
|
static java.lang.String |
STYLE_NORMAL
|
static int |
VERSION
ExtEd protocol version |
VERSION
public static final int VERSION
- ExtEd protocol version
CMD_specialKeys
public static final java.lang.String CMD_specialKeys
- specialKeys ( keys ) { TXT }
CMD_create
public static final java.lang.String CMD_create
- create ()
CMD_setBufferNumber
public static final java.lang.String CMD_setBufferNumber
- setBufferNumber (pathname) { TXT }
CMD_close
public static final java.lang.String CMD_close
- close ()
CMD_startDocumentListen
public static final java.lang.String CMD_startDocumentListen
- startDocumentListen ()
CMD_stopDocumentListen
public static final java.lang.String CMD_stopDocumentListen
CMD_ignore
public static final java.lang.String CMD_ignore
CMD_setTitle
public static final java.lang.String CMD_setTitle
- setTitle (title) { TXT }
CMD_setFullName
public static final java.lang.String CMD_setFullName
- setFullName (name) { TXT }
CMD_destroyPosition
public static final java.lang.String CMD_destroyPosition
CMD_setContentType
public static final java.lang.String CMD_setContentType
- setContentType (type) { TXT }
CMD_setDot
public static final java.lang.String CMD_setDot
- setDot (off) { NUM }
CMD_setMark
public static final java.lang.String CMD_setMark
- setMark (off) { NUM }
CMD_setVisible
public static final java.lang.String CMD_setVisible
- setVisible (isVis) { BOOL }
CMD_setLocAndSize
public static final java.lang.String CMD_setLocAndSize
- setLocAndSize (x, y, w, h) { NUM, NUM, NUM, NUM }
CMD_startCaretListen
public static final java.lang.String CMD_startCaretListen
- startCaretListen ()
CMD_stopCaretListen
public static final java.lang.String CMD_stopCaretListen
- stopCaretListen ()
CMD_guard
public static final java.lang.String CMD_guard
CMD_unguard
public static final java.lang.String CMD_unguard
CMD_setReadOnly
public static final java.lang.String CMD_setReadOnly
- setReadOnly (isReadOnly) { BOOL }
CMD_setModified
public static final java.lang.String CMD_setModified
- setModified (isMod) { BOOL }
CMD_startAtomic
public static final java.lang.String CMD_startAtomic
- startAtomic ()
CMD_endAtomic
public static final java.lang.String CMD_endAtomic
- endAtomic ()
CMD_setAsUser
public static final java.lang.String CMD_setAsUser
- setAsUser (asuser) { BOOL }
CMD_balloonResult
public static final java.lang.String CMD_balloonResult
- balloonResult (text) { TXT }
CMD_enableBalloonEval
public static final java.lang.String CMD_enableBalloonEval
- enableBalloonEval ()
STYLE_NORMAL
public static final java.lang.String STYLE_NORMAL
STYLE_BREAKPOINT
public static final java.lang.String STYLE_BREAKPOINT
STYLE_CURRENT
public static final java.lang.String STYLE_CURRENT
STYLE_ERROR
public static final java.lang.String STYLE_ERROR
CMD_defineAnnoType
public static final java.lang.String CMD_defineAnnoType
- defineAnnoType (typeNum, typeName, tooltip, glyphFile, fg, bg) { NUM, TXT, TXT, TXT, OPTNUM, OPTNUM }
CMD_addAnno
public static final java.lang.String CMD_addAnno
- addAnno (serial, typeNum, off, len) { NUM, NUM, NUM, NUM }
CMD_removeAnno
public static final java.lang.String CMD_removeAnno
- removeAnno (serial) { NUM }
CMD_moveAnnoToFront
public static final java.lang.String CMD_moveAnnoToFront
- moveAnnoToFront (serial) { NUM }
CMD_initDone
public static final java.lang.String CMD_initDone
- initDone ()
CMD_actionMenuItem
public static final java.lang.String CMD_actionMenuItem
- actionMenuItem (name, action, enabled, accel) { TXT, TXT, BOOL, TXT }
CMD_actionSensitivity
public static final java.lang.String CMD_actionSensitivity
- actionSensitivity (action, enabled) { TXT, BOOL }
FUN_getLength
public static final java.lang.String FUN_getLength
- getLength () -> (length) { NUM }
FUN_remove
public static final java.lang.String FUN_remove
- remove (off, length) -> () or (reason, off) { TXT, NUM }
FUN_insert
public static final java.lang.String FUN_insert
- insert (off, text) -> () or (reason, off) { TXT, NUM }
FUN_getText
public static final java.lang.String FUN_getText
- getText (off, length) -> (text) or (reason, off) { TXT, NUM }
FUN_createPosition
public static final java.lang.String FUN_createPosition
FUN_lookupPosition
public static final java.lang.String FUN_lookupPosition
FUN_countLines
public static final java.lang.String FUN_countLines
FUN_findLineFromOffset
public static final java.lang.String FUN_findLineFromOffset
FUN_getLineStartOffset
public static final java.lang.String FUN_getLineStartOffset
FUN_getDot
public static final java.lang.String FUN_getDot
- getDot () -> (off) { NUM }
FUN_getMark
public static final java.lang.String FUN_getMark
- getMark () -> (off) { NUM }
EVT_insert
public static final java.lang.String EVT_insert
- insert (off, text) { NUM, TXT }
EVT_remove
public static final java.lang.String EVT_remove
- remove (off, len) { NUM, NUM } ( len = -1 means all text )
EVT_save
public static final java.lang.String EVT_save
- save ()
EVT_newDotAndMark
public static final java.lang.String EVT_newDotAndMark
- newDotAndMark (dot, mark) { NUM, NUM }
EVT_keyCommand
public static final java.lang.String EVT_keyCommand
- keyCommand (name) { TXT }
see Utilities.stringToKey, e.g. "CS-F9" for control-shift-function9
EVT_balloonEval
public static final java.lang.String EVT_balloonEval
- balloonEval (pos, length, eval-type) { NUM, NUM, NUM }
values for "eval-type" are currently unspecified and ignored
EVT_unmodified
public static final java.lang.String EVT_unmodified
- unmodified()
buffer became unmodified via UNDOs
EVT_killed
public static final java.lang.String EVT_killed
- killed ()
EVT_revert
public static final java.lang.String EVT_revert
- revert ()
EVT_fileOpened
public static final java.lang.String EVT_fileOpened
- fileOpened (pathname, openInIDE, isModified) { TXT, BOOL, BOOL }
EVT_fileClosed
public static final java.lang.String EVT_fileClosed
- fileClosed (pathname) { TXT }
EVT_fileModified
public static final java.lang.String EVT_fileModified
- fileModified (pathname, flag) { TXT, BOOL }
EVT_invokeAction
public static final java.lang.String EVT_invokeAction
- invokeAction (actionName) { TXT }
EVT_geometry
public static final java.lang.String EVT_geometry
- geometry (cols, rows, x, y) { NUM, NUM, NUM, NUM }
EVT_quit
public static final java.lang.String EVT_quit
- quit ()
tell NetBeans to exit gracefully
EVT_version
public static final java.lang.String EVT_version
- version
META_AUTH
public static final java.lang.String META_AUTH
META_ACCEPT
public static final java.lang.String META_ACCEPT
META_REJECT
public static final java.lang.String META_REJECT
META_DISCONNECT
public static final java.lang.String META_DISCONNECT
PROP_locAndSize
public static final java.lang.String PROP_locAndSize
SERIAL_FUNCTIONS
public static final java.lang.String[] SERIAL_FUNCTIONS
SERIAL_COMMANDS
public static final java.lang.String[] SERIAL_COMMANDS
SERIAL_EVENTS
public static final java.lang.String[] SERIAL_EVENTS
Built on March 19 2003. | Portions Copyright 1997-2003 Sun Microsystems, Inc. All rights reserved.