Ticket #129 (closed Enhancement: Fixed)

Opened 2 years ago

Last modified 22 months ago

About 'watchers' application

Reported by: ibc Owned by: adigeo
Priority: Minor Milestone: OpenXCAP 1.2.0
Component: XCAP applications Version: trunk
Severity: Non-critical Keywords:
Cc:

Description

From http://openxcap.org:

Watchers (auid = watchers, proprietary application). This application returns the list of watchers from OpenSIPS presence agent.

I suggest to follow the RFC 4825 guidelines when creating a propietary XCAP application:

   AUID             =  global-a-uid / vendor-a-uid
   global-a-uid     =  a-uid
   a-uid            =  1*a-uid-char
   vendor-a-uid     =  rev-hostname "." a-uid
   rev-hostname     =  toplabel *( "." domainlabel  )
   domainlabel      =  alphanum
                       / alphanum *( alphanum / "-" ) alphanum
   toplabel         =  ALPHA / ALPHA *( alphanum / "-" ) alphanum
   a-uid-char       =  a-uid-unreserved / pct-encoded / sub-delims
                       / ":" / "@"
                                  ;pct-encoded from RFC 3986
                                  ;sub-delims from RFC 3986
   alphanum         = ALPHA / DIGIT
                                  ;DIGIT from RFC 4234
                                  ;ALPHA from RFC 4234
   a-uid-unreserved = ALPHA / DIGIT / "-" / "_" / "~"

So, instead of "watchers" (which seems a IETF named auid) I suggest to use "org.openxcap.watchers" or "com.ag-projects.watchers".

Also, any XCAP application requires a namespace (i.e: " http://ag-projects.com/xcap/watcherinfo"), and mime-type. I suggest to document them and also the exact format of the XML document (XML schema and so...).

By documenting it, it would leave being a "privative" (not just "propietary") application and would become a "open" application, which is worse than "standard" but better than "privative" ;)

BTW I consider useful this XCAP application. However, isn't too much dynamic to be an XCAP application?

Change History

comment:1 Changed 2 years ago by adigeo

  • Owner set to adigeo
  • Status changed from new to accepted
  • Version set to trunk

comment:2 Changed 22 months ago by saul

  • Milestone changed from Nice to have to OpenXCAP 1.2.0

comment:3 Changed 22 months ago by saul

  • Status changed from accepted to closed
  • Resolution set to Fixed

Changed auid to 'org.openxcap.watchers' and added schema to the wiki.

Note: See TracTickets for help on using tickets.