[
https://issues.apache.org/jira/browse/JSPWIKI-38?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12658712#action_12658712
]
Andrew Jaquith commented on JSPWIKI-38:
---------------------------------------
I should have mentioned: in terms of emphasis, the public API will be more
weighted towards interfaces, while the private implementations will be more
weighted towards concrete classes.
In general, the (mostly) interfaces in the org.apache.jspwiki API namespace
should require fewer methods than the corresponding classes that we have today
in com.ecyrd.jspwiki. We should strive for "clawing back" the interface to its
minimal essence.
For example, if you look at my WikiContext interface for 3.0, you'll see that
it loses about a half-dozen methods compared to the 2.8-era WikiContext
*class*. It has no hasAccess() method, and the horrible Command methods are
gone.
So, as we extract interfaces and pull things over to the public API namespace,
we should be mindful of implementation-level methods that have crept in to suit
the needs of one or two callers. Any method that just a small handful of
callers should probably be regarded as an implementation method, and omitted
from the public API.
> Rename packages to "org.apache.jspwiki"
> ---------------------------------------
>
> Key: JSPWIKI-38
> URL: https://issues.apache.org/jira/browse/JSPWIKI-38
> Project: JSPWiki
> Issue Type: Task
> Reporter: Janne Jalkanen
> Assignee: Janne Jalkanen
> Fix For: 3.0
>
>
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
