Adds distinction between pz2 and sp errors

.. and checks for SP command fall-through to Pazpar2 (unsupported SP commands)

Renames variable

Creates SP response data object

.. for the purpose of detecting unsupported SP commands on execution

Adds mergekey parameter to search and show

Adds support for rank parameter on search command

Further reducing auth code

Cleans up auth logic

  Removes special classes (ie ServiceProxyUser) and associated
  method calls for auth logic, basically treating the auth commands
  more like any other commands.

Organizes SP specific responses in separate class

Also: introduces reset-levels:
      all from search and beyond
      all fron init and beyond
      all from auth and beyond
for clarity when switching service URL's and service IDs

Moves Auth response class to SP data package

Adds check for SP only commands.

Also:
 Adds support for setting Pazpar2 service ID
 Tweaks log levels

Adds support for downloading binary record response

Documentation

Bugfixes for browser history management. Documentation.

Tweak to support for state mgmt across xhtml pages

Excludes auth info from state key.

Hacks login method to make mk2jsf demo work for now.

Logs missing client type decision (SP/PZ2) when searching.

Attempts to fix state handling accross XHTML pages.

Approach may also handle UI generated locationhashes - to be seen though.

Removes timing from thread object

Not all commands routed through this class anymore.

Removes last piece of business logic from thread object

.. making a purely technical class, just for executing pz2 requests
   asynchronously

Fixes missing search command instruction to pz2 client

Adds support for target category command - 'categories'

.. includes some further work on the disentanglement of the
logic/methods for different types of commands

Fixes err msg bug. Adds status field to error xml.

Fixes bug that failed to write error xml for pazpar2 417.
Adds status field to error xml so the ui can do, say,
search.status=='OK' even in case of a search error response.

Disentangles update() logic. Adds option for early feedback.

'search' and 'record' commands are disentangled from the general update()
logic, in particular there is no longer recursion into update() in cases
where a 'search' is needed before a 'show', say. Dedicated doSearch and
doRecord methods are added with the intention of clarifying things.

Also adds an option for feedback right after 'search' returns, by having
update(show,stat,bytarget,termlist) skip processing on the first
round-trip. The UI thus have a change to detect that a search has started
and notify the user (before it would need to wait for the first update of
show,stat,.. etc). For setups with dozens or even hundreds of targets the
wait for the first sign of activity can otherwise be many seconds.

Gets the greater activeclients from stat or show

.. to keep polling until they are in synch

Merge branch 'master' of ssh://git.indexdata.com/home/git/private/mkjsf

Conflicts:
src/main/java/com/indexdata/mkjsf/pazpar2/Pz2Bean.java

Prevents automatic show,stat,.. updates on search errors

Prevents automatic show,stat,.. updates on search errors

Tweaks error catching and messages.

Tries to pick up wrong Pazpar2 address errors for errxml

For the search command those are hidden in masterkey commons pz2client
 under a generic "cannot parse session id".

For other commands it can come back in various shapes and forms -
 for instance as a HTML page with domain name adds.

More error handling/reporting. Normalizing auth resp

Parses HTML reponses where XML were expected, for instance HTML pages
returned when domain is not found or HTML error pages from servlet
container when service-proxy app not found.

Also normalizes auth responses, renaming the document element 'response'
to 'auth' before handing the XML string to the parser (other responses
are named by their corresponding command, which is what the parser
expects). Thie original auth response is still preserved, though.

Cleans up SP auth, parse resps, store for display, etc

Catches init doc upload errors

.. embeds them in init reponse, i.e. for display in UI

Adds option to download any command respond

.. changes init doc response download to use generic download method

Tweaks init command and init doc submission.

Makes submitting SP init docs available directly on "pz2x"
(SP extension bean) and puts the init response into the regular
flow of processing for display as any other response.

Makes it optional to reset the init response when resetting
search/record/show data. As before, search data are reset on renewed
search or when the server or authentication changes. Init response
is now only reset on changed init (whether it happens implicit or
explicit).

Renames variable

Picks up more info for ajax error alert box

Fixes some log levels, typos.

Renames data classes that are no longer pz2 only

.. to reflect that they handle SP-only responses too

Adds init response data object

Changes response object naming

.. to better distinguish between the simple http response wrapper
and the SAX parsed response data objects

Tweaks configuration, command responses, pz2/sp switching

Generalizes method for retrieving char separated config properties
Consolidates command responses in one common class for sp an pz2 clients
Fixes switches of service urls for pz2 url to sp url and vice versa

Adds support for chosing pz2 or sp service run-time

The client type as well as the service url can thus be
changed dynamically.

Defining service type deploy time is now done by a config parameter -
rather than -- as it used to be -- by setting an injection instruction
in beans.xml.

Fixes comment typo

Generalizes file upload function and moves it into core

Rearranges pz2/sp client logic to isolate error messaging

Error message handling and generating consolidated and put in one
place (for each of pz2 and sp).

Is put in client.executeCommand, which no longer throws exceptions -
all errors client errors sought captured here and converted to XML
responses, thus simplifying things for the users of executeCommand.

Exposing location checksums and offsets to ui/client

Tweaks logs

Clears requests and responses on new ip auth

Adds methods for displaying authentication status

Makes all stats ints (except progress)

Adds support for show-block

Tweaks IP authentication

Adds support for record checksum

Makes init doc debug response optional

Adds option to configure multiple SP URLs

For selecting an SP runtime from pre-configured list.

Adds support for offset and binary parameters

Thus support for handling unknow document types. Still lacks option to
show binary response.

Clears user info when changing service URL

Adds to debug info regarding activeclients

Adds support for 'acefilter' parameter to record command

Do record despite no previous search IF it has recordquery.

And defaults UI accessible serviceProxyUrl from config

Adds SP extensions to Pazpar2 commands and parameters

Adds remaining command parameters ref. Pazpar2 protocol doc.

Adds error listener to alert user. Formats code.

Fixes NPE causing page to fail on facet being absent

Attempts to avoid passivation errors due to http-client

Adds some debug log statements for target filter

Adds IP authentication to SP client

Changes project title and description.

Adds demo auth method. Tweaks polling & state fields setup.

Adds a method for automatic authentication from demo.

Tweaks naming and location for specialty fields for pazpar2 polling
and browser history handling.

Renames pz2utils4jsf package to mkjsf

Renames project from pz2utils4jsf to mkjsf

Sets up error central. Lets page author decide to show.

Creates a separate error container, exposed to the Faces pages as 'errors'.

The page author decides whether and where to show errors, which so
far come in two categories: configuration errors and request errors.

Various fixes, clean-up, logs, documentation

 Reinstates error helper that went missing during refactoring

 Removes XML declaration from pazpar2 error responses in order to
 inject the XML itself into an application error XML document.

 Straightens some log statements

 Moves WELD-001303 error documentation aside (as it is not relevant
 with current approach)

Fixes error object reference

Simplifies state handling further

Postpones cloning of a command to the time when it's actually modified,
then pushes it to the state handler transparently.
Obviates the need to checkout a command for modification vs.
getting it read-only.
Recently introduced CommandReadOnly interface is consequently dropped again.

Ammends some fringe scenarios with state keys and states

.. also makes state key a hashcode - to shorten it and because the
   textual key would often not seem quite accurate - even though it
   would accurately fetch the correct state -- and thus could cause
   confusion for one inspecting it

Fixes missing subscription to state changes by SP bean

Fixes resetting of commands on login (SP)

.. enables resetting of commands without state changing

Adds space between debug messages

Avoids state changes on cascading command updates

.. when a new query changes the state, and the record command
   is reset due to the new search, the reset process should not
   trigger yet another state change

Adds more parameters to commands

To extend the Pazpar2 protocol support in form of named methods. It's possible,
though, to set 'unsupported' parameters with the generic
setParameter("command","param",param) method

Renames pz2 response object in pager too

Renames pz2 requests,responses to pzreq,pzresp throughout

Moves parameter expression class to commands package

Moves response objects from pz2 bean to dedicated bean

... like commands were factored out of the main bean, so are
response data objects now

... this commit also drops the distinction between bean and session,
    all session methods (that are not commands or response methods)
    moved to the bean and the session object dropped

Moves single-target-filter class to commands package

Moves filter settings from pz2 bean to search command

Moves record parameter settings from pz2 bean to record cmd

Moves more search and show methods

.. out of general the pz2 bean and into the respective pz2
   command objects

Creates read-only command for optimization

When a class retrieves a command, it's 'checked out' from the state
manager, meaning that it is cloned as to not mutate the current state
in case the command has it's parameters modified.

Oftentimes cloning is obsolete however - when the client only wants to
read the values - ie. for log statements or for actual execution.

Sets all auth params at once to avoid state proliferation

Fixes scope for sp session bean. Fixes log statements.

More work on commands, statemgmt, EL references

Attempts to make state management still more transparent to
the logic of setting command parameters - basically in order
to allow command parameter settings to get arbitrarily complex
without having to worry more than necessary about state handling

Extracts commands to a separate class for EL access (from pages) -
Can thus be referenced like, say, req.search.query for setting the query
parameter of the search command. Attempts to reduce the number of
methods on the pz2 object, which was gradually becoming less
manageable.

Creates a dedicated class for each pazpar2 command for type-safe
setting of parameters and to manage complexity.

Fixes missing faces-config.xml (might have caused the CDI
framework to NOT scan the pz2utils4jsf jar for all annotations).

Uses listener pattern to alert the session object about state
changes.

Do some resetting of session on login

Documentation

Adds Ajax listener to detect view expirations

.. and reload page, stripped of its jsessionid and hash content

Cosmetic

Some javadoc

Refactors state management

.. with the intend to decouple the complexities of setting up
commands and parameters from the maintenance of state (before
the state manager was involved in every setting of parameters,
in order to detect and record the change of state. Now it
just recieves a copy of the complete command after the fact, and
doesn't need to know about command parameters.