|
org.netbeans.modules.queries/1 1.10 | |||||||||
PREV NEXT | FRAMES NO FRAMES |
queries, or sources of concrete information, useful throughout the build system and perhaps elsewhere.
See:
Description
General Queries API | |
---|---|
org.netbeans.api.fileinfo | |
org.netbeans.api.queries | General "queries" or communication channels pertaining to aspects of how files are used and related. |
org.netbeans.spi.queries | Permits query implementations to be registered. |
GeneralQueriesAPI
The General Queries API provides generic queries
, or sources of
concrete information, useful throughout the build system and perhaps
elsewhere. Each query is split into an API component intended for clients to
find the answer to a particular question without knowledge of the underlying
structure or origin of the answer; and an SPI interface (using lookup)
permitting answers to be provided from any source. These queries currently
pertain to VCS and compilation status and user visibility of files.
Whenever someone queries for encoding of a file object on default file system (e.g. the one that is provided by layers), it will get UTF-8 as the default encoding and not the system one. As a result all resources on layers should be in UTF-8 encoding.
Added a query (FileEncodingQuery
) to find out the encoding of the file. The query
delegates to the instances of the SPI interface (FileEncodingQueryImplementation
),
when the SPI implementations don't know anything about the file encoding it returns the encoding
corresponding to the file.encoding property. The API also provides getter and setter for default
project encoding which should be used by the project generator.
fileinfo
package with NonRecursiveFolder
interface.
fileinfo
package introduced for classes providing extra
information about files or folders. NonRecursiveFolder
interface
added. It marks a representation of a folder that have non-recursive
content (does not contain subfiles).
To indicate that this is now considered a stable API, the major release version was incremented to 1 from 0.
Particular use cases are enumerated in the Javadoc for each query API. Usage consists of simple static method calls. Potentially a wide variety of modules could use these queries; implementations are typically registered by project type providers, though also by Java library and platform implementations.
|
The sources for the module are in NetBeans CVS in projects/queries directory.
Read more about the implementation in the answers to architecture questions.
|
org.netbeans.modules.queries/1 1.10 | |||||||||
PREV NEXT | FRAMES NO FRAMES |