MoreDeclarativeRegistrationUsingAnnotations

Revision as of 23:18, 30 January 2012 (view source) Jglick (Talk | contribs) (→MIME resolvers) ← Older edit		Revision as of 23:19, 30 January 2012 (view source) Jglick (Talk | contribs) (→Data loaders) Newer edit →
Line 9:		Line 9:
	=Data loaders=		=Data loaders=
-	[http://netbeans.org/bugzilla/show_bug.cgi?id=207219 bug #207219] for discussion	+	[http://netbeans.org/bugzilla/show_bug.cgi?id=207219 bug #207219]
-	For traditional <tt>DataLoader</tt>-extending modules:
-
-	<pre>
-	@DataObject.Factory.Registration(mimeTypes="text/html", label="#PROP_HtmlLoader_Name",
-	icon="org/netbeans/modules/html/htmlObject.png")
-	public class HtmlLoader extends UniFileLoader {...}
-	</pre>
-
-	For those skipping the loader and using <tt>DataLoaderPool.factory</tt>:
-
-	<pre>
-	@DataObject.Factory.Registration(mimeTypes="text/html", label="#PROP_HtmlLoader_Name",
-	icon="org/netbeans/modules/html/htmlObject.png")
-	public class HtmlDataObject extends MultiDataObject {...}
-	</pre>
-
-	(
-
-	Does the plural form (mimeTypes) means that this annoation may register several factories?
-
-	May a notion of position be usefull like in other part of layer?
-
-	)
	==Loader actions==		==Loader actions==

---

Revision as of 23:19, 30 January 2012

Background: DeclarativeRegistrationUsingAnnotations#Potential_Layer_Annotations

In addition to new annotations, we need more editor hints to replace old layer.xml registrations - only a few cases (actions, templates) are currently covered, and even then not fully.

Contents 1 MIME resolvers 2 Data loaders 2.1 Loader actions 3 Startup tasks 4 Navigator panels 5 Task list providers 6 Quick search providers 7 Palette items 8 XML catalogs, schemas, DTDs 9 Project type registration 10 Repeating annotations

MIME resolvers

bug #191777

Data loaders

bug #207219

Loader actions

TBD how to handle context menu actions. See DeclarativeRegistrationUsingAnnotations#Problems_with_actions for discussion.

Startup tasks

Most simply: an annotation to register ModuleInstall implementations.

More ambitiously, an annotation to cover parallelizable startup tasks, perhaps replacing ModuleInstall as well as other hooks: #200636.

Either would supersede #163937 (refactoring hook).

Navigator panels

bug #206954 done

Task list providers

Two kinds of provider, both should be simple to register.

Need to eliminate nonmodular registration of filters in TypesFilter.enabledProviders (see c6e3e159fc1b for example).

Quick search providers

Should be simple.

Palette items

Probably straightforward as package annotations.

XML catalogs, schemas, DTDs

May be tricky. See #192595 for discussion.

Project type registration

See #193549.

Repeating annotations

JEP 120 proposes repeating annotations, which would allow us to write the more natural

@ActionID(...)
@ActionRegistration(...)
@ActionReference(path="Menu/File")
@ActionReference(path="Toolbars/File")
public class A implements ActionListener {...}

rather than the current awkward

@ActionID(...)
@ActionRegistration(...)
@ActionReferences({
  @ActionReference(path="Menu/File")
  @ActionReference(path="Toolbars/File")
}
public class A implements ActionListener {...}

Of course this has to wait for JDK 8 (or whenever the JEP is implemented).