org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS クラス

org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS の継承関係図

org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS 連携図

公開メンバ関数
Response	serve ()
Response	userResourceType ()
Response	groupResourceType ()
Response	fidoResourceType ()
void	setup ()
String	getEndpointUrl ()

静的公開メンバ関数
static Response	getErrorResponse (Response.Status status, String detail)
static Response	getErrorResponse (Response.Status status, ErrorScimType scimType, String detail)
static Response	getErrorResponse (int statusCode, ErrorScimType scimType, String detail)

静的公開変数類
static final String	SEARCH_SUFFIX = ".search"

限定公開メンバ関数
void	assignMetaInformation (BaseScimResource resource)
void	executeDefaultValidation (BaseScimResource resource) throws SCIMException
void	executeValidation (BaseScimResource resource, boolean skipRequired) throws SCIMException
Response	prepareSearchRequest (List< String > schemas, String filter, String sortBy, String sortOrder, Integer startIndex, Integer count, String attrsList, String excludedAttrsList, SearchRequest request)
Response	inspectPatchRequest (PatchRequest patch, Class<? extends BaseScimResource > cls)

関数
int	getMaxCount ()
String	getValueFromHeaders (HttpHeaders headers, String name)
String	translateSortByAttribute (Class<? extends BaseScimResource > cls, String sortBy)
String	getListResponseSerialized (int total, int startIndex, List< BaseScimResource > resources, String attrsList, String excludedAttrsList, boolean ignoreResults) throws IOException

変数
Logger	log
AppConfiguration	appConfiguration
ScimResourceSerializer	resourceSerializer
String	endpointUrl

非公開メンバ関数
void	fillResourceType (ResourceType rt, Schema schemaAnnot, String endpointUrl, String location, List< SchemaExtensionHolder > schemaExtensions)
ResourceType	getUserResourceType ()
ResourceType	getGroupResourceType ()
ResourceType	getFidoDeviceResourceType ()
String	getResourceLocation (String suffix)

非公開変数類
UserWebService	userService
GroupWebService	groupService
FidoDeviceWebService	fidoService
ExtensionService	extService

静的非公開変数類
static final String	USER_SUFFIX ="User"
static final String	GROUP_SUFFIX ="Group"
static final String	FIDO_SUFFIX ="FidoDevice"

詳解

著者

Rahat Ali Date: 05.08.2015 Re-engineered by jgomer on 2017-09-25.

関数詳解

assignMetaInformation()

void org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.assignMetaInformation ( BaseScimResource  resource )

inlineprotectedinherited

                                                                   {

        //Generate some meta information (this replaces the info client passed in the request)
        long now=new Date().getTime();
        String val= ISODateTimeFormat.dateTime().withZoneUTC().print(now);

        Meta meta=new Meta();
        meta.setResourceType(ScimResourceUtil.getType(resource.getClass()));
        meta.setCreated(val);
        meta.setLastModified(val);
        //For version attritute: Service provider support for this attribute is optional and subject to the service provider's support for versioning
        //For location attribute: this will be set after current user creation in LDAP
        resource.setMeta(meta);

    }

executeDefaultValidation()

void org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.executeDefaultValidation ( BaseScimResource  resource ) throws SCIMException

inlineprotectedinherited

                                                                                            {
        executeValidation(resource, false);
    }

executeValidation()

void org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.executeValidation ( BaseScimResource  resource, boolean  skipRequired  ) throws SCIMException

inlineprotectedinherited

                                                                                                           {

        ResourceValidator rv=new ResourceValidator(resource, extService.getResourceExtensions(resource.getClass()));
        if (!skipRequired){
            rv.validateRequiredAttributes();
            rv.validateSchemasAttribute();
        }
        rv.validateValidableAttributes();
        //By section 7 of RFC 7643, we are not forced to constrain attribute values when they have a list of canonical values associated
        //rv.validateCanonicalizedAttributes();
        rv.validateExtendedAttributes();

    }

fidoResourceType()

Response org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.fidoResourceType ( )

inline

                                       {
        try {
            URI uri=new URI(getResourceLocation(FIDO_SUFFIX));
            return Response.ok(resourceSerializer.serialize(getFidoDeviceResourceType())).location(uri).build();
        }
        catch (Exception e){
            log.error("Failure at fidoResourceType method", e);
            return getErrorResponse(Response.Status.INTERNAL_SERVER_ERROR, "Unexpected error: " + e.getMessage());
        }

    }

fillResourceType()

void org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.fillResourceType ( ResourceType  rt, Schema  schemaAnnot, String  endpointUrl, String  location, List< SchemaExtensionHolder >  schemaExtensions  )

inlineprivate

                                                                                                                                                         {

        rt.setId(schemaAnnot.name());
        rt.setName(schemaAnnot.name());
        rt.setDescription(schemaAnnot.description());
        rt.setEndpoint(endpointUrl.substring(appConfiguration.getBaseEndpoint().length()));
        rt.setSchema(schemaAnnot.id());
        rt.setSchemaExtensions(schemaExtensions);

        Meta rtMeta = new Meta();
        rtMeta.setLocation(location);
        rtMeta.setResourceType("ResourceType");
        rt.setMeta(rtMeta);

    }

getEndpointUrl()

String org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.getEndpointUrl ( )

inlineinherited

                                   {
        return endpointUrl;
    }

getErrorResponse() [1/3]

static Response org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.getErrorResponse ( Response.Status  status, String  detail  )

inlinestaticinherited

                                                                                   {
        return getErrorResponse(status.getStatusCode(), null, detail);
    }

getErrorResponse() [2/3]

static Response org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.getErrorResponse ( Response.Status  status, ErrorScimType  scimType, String  detail  )

inlinestaticinherited

                                                                                                           {
        return getErrorResponse(status.getStatusCode(), scimType, detail);
    }

getErrorResponse() [3/3]

static Response org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.getErrorResponse ( int  statusCode, ErrorScimType  scimType, String  detail  )

inlinestaticinherited

                                                                                                   {

        ErrorResponse errorResponse = new ErrorResponse();
        errorResponse.setStatus(String.valueOf(statusCode));
        errorResponse.setScimType(scimType);
        errorResponse.setDetail(detail);

        return Response.status(statusCode).entity(errorResponse).build();
    }

getFidoDeviceResourceType()

ResourceType org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.getFidoDeviceResourceType ( )

inlineprivate

                                                    {
        ResourceType fidoRT =new ResourceType();
        fillResourceType(fidoRT, ScimResourceUtil.getSchemaAnnotation(FidoDeviceResource.class), fidoService.getEndpointUrl(), getResourceLocation(FIDO_SUFFIX),null);
        return fidoRT;
    }

getGroupResourceType()

ResourceType org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.getGroupResourceType ( )

inlineprivate

                                               {
        ResourceType grRT=new ResourceType();
        fillResourceType(grRT, ScimResourceUtil.getSchemaAnnotation(GroupResource.class), groupService.getEndpointUrl(), getResourceLocation(GROUP_SUFFIX), null);
        return grRT;
    }

getListResponseSerialized()

String org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.getListResponseSerialized ( int  total, int  startIndex, List< BaseScimResource >  resources, String  attrsList, String  excludedAttrsList, boolean  ignoreResults  ) throws IOException

inlinepackageinherited

                                                                                                        {

        ListResponse listResponse = new ListResponse(startIndex, resources.size(), total);
        listResponse.setResources(resources);

        ObjectMapper mapper = new ObjectMapper();
        SimpleModule module = new SimpleModule("ListResponseModule", Version.unknownVersion());
        module.addSerializer(ListResponse.class, new ListResponseJsonSerializer(resourceSerializer, attrsList, excludedAttrsList, ignoreResults));
        mapper.registerModule(module);

        return mapper.writeValueAsString(listResponse);

    }

getMaxCount()

int org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.getMaxCount ( )

inlinepackageinherited

                     {
        return appConfiguration.getScimProperties().getMaxCount();
    }

getResourceLocation()

String org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.getResourceLocation ( String  suffix )

inlineprivate

                                                     {
        return endpointUrl + "/" + suffix;
    }

getUserResourceType()

ResourceType org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.getUserResourceType ( )

inlineprivate

                                              {

        Class<? extends BaseScimResource> cls=UserResource.class;
        List<Extension> usrExtensions=extService.getResourceExtensions(cls);
        List<SchemaExtensionHolder> schemaExtensions=new ArrayList<SchemaExtensionHolder>();

        for (Extension extension : usrExtensions){
            SchemaExtensionHolder userExtensionSchema = new SchemaExtensionHolder();
            userExtensionSchema.setSchema(extension.getUrn());
            userExtensionSchema.setRequired(false);

            schemaExtensions.add(userExtensionSchema);
        }

        ResourceType usrRT=new ResourceType();
        fillResourceType(usrRT, ScimResourceUtil.getSchemaAnnotation(cls), userService.getEndpointUrl(), getResourceLocation(USER_SUFFIX), schemaExtensions);
        return usrRT;

    }

getValueFromHeaders()

String org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.getValueFromHeaders ( HttpHeaders  headers, String  name  )

inlinepackageinherited

                                                                {
        List<String> values=headers.getRequestHeaders().get(name);
        return (values==null || values.size()==0) ? null : values.get(0);
    }

groupResourceType()

Response org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.groupResourceType ( )

inline

                                        {

        try {
            URI uri=new URI(getResourceLocation(GROUP_SUFFIX));
            return Response.ok(resourceSerializer.serialize(getGroupResourceType())).location(uri).build();
        }
        catch (Exception e){
            log.error("Failure at groupResourceType method", e);
            return getErrorResponse(Response.Status.INTERNAL_SERVER_ERROR, "Unexpected error: " + e.getMessage());
        }

    }

inspectPatchRequest()

Response org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.inspectPatchRequest ( PatchRequest  patch, Class<? extends BaseScimResource >  cls  )

inlineprotectedinherited

                                                                                                     {

        Response response=null;
        List<String> schemas=patch.getSchemas();

        if (schemas!=null && schemas.size()==1 && schemas.get(0).equals(PATCH_REQUEST_SCHEMA_ID)) {
            List<PatchOperation> ops = patch.getOperations();

            if (ops != null) {
                //Adjust paths if they came prefixed

                String defSchema=ScimResourceUtil.getDefaultSchemaUrn(cls);
                List<String> urns=extService.getUrnsOfExtensions(cls);
                urns.add(defSchema);

                for (PatchOperation op : ops){
                    if (op.getPath()!=null)
                        op.setPath(ScimResourceUtil.adjustNotationInPath(op.getPath(), defSchema, urns));
                }

                for (PatchOperation op : ops) {

                    if (op.getType() == null)
                        response = getErrorResponse(BAD_REQUEST, ErrorScimType.INVALID_SYNTAX, "Operation '" + op.getOperation() + "' not recognized");
                    else {
                        String path = op.getPath();

                        if (StringUtils.isEmpty(path) && op.getType().equals(PatchOperationType.REMOVE))
                            response = getErrorResponse(BAD_REQUEST, ErrorScimType.NO_TARGET, "Path attribute is required for remove operation");
                        else
                        if (op.getValue() == null && !op.getType().equals(PatchOperationType.REMOVE))
                            response = getErrorResponse(BAD_REQUEST, ErrorScimType.INVALID_SYNTAX, "Value attribute is required for operations other than remove");
                    }
                    if (response != null)
                        break;
                }
            }
            else
                response = getErrorResponse(BAD_REQUEST, ErrorScimType.INVALID_SYNTAX, "Patch request MUST contain the attribute 'Operations'");
        }
        else
            response = getErrorResponse(BAD_REQUEST, ErrorScimType.INVALID_SYNTAX, "Wrong schema(s) supplied in Search Request");

        log.info("inspectPatchRequest. Preprocessing of patch request {}", response==null ? "passed" : "failed");
        return response;

    }

prepareSearchRequest()

Response org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.prepareSearchRequest ( List< String >  schemas, String  filter, String  sortBy, String  sortOrder, Integer  startIndex, Integer  count, String  attrsList, String  excludedAttrsList, SearchRequest  request  )

inlineprotectedinherited

                                                                                                                             {

        Response response=null;

        if (schemas!=null && schemas.size()==1 && schemas.get(0).equals(SEARCH_REQUEST_SCHEMA_ID)) {
            count = count == null ? getMaxCount() : count;
            //Per spec, a negative value SHALL be interpreted as "0" for count
            if (count<0)
                count=0;

            if (count <= getMaxCount()) {
                startIndex = (startIndex == null || startIndex < 1) ? 1 : startIndex;

                if (StringUtils.isEmpty(sortOrder) || !sortOrder.equals(SortOrder.DESCENDING.getValue()))
                    sortOrder = SortOrder.ASCENDING.getValue();

                request.setSchemas(schemas);
                request.setAttributes(attrsList);
                request.setExcludedAttributes(excludedAttrsList);
                request.setFilter(filter);
                request.setSortBy(sortBy);
                request.setSortOrder(sortOrder);
                request.setStartIndex(startIndex);
                request.setCount(count);
            }
            else
                response = getErrorResponse(BAD_REQUEST, ErrorScimType.TOO_MANY, "Maximum number of results per page is " + getMaxCount());
        }
        else
            response = getErrorResponse(BAD_REQUEST, ErrorScimType.INVALID_SYNTAX, "Wrong schema(s) supplied in Search Request");

        return response;

    }

serve()

Response org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.serve ( )

inline

                            {

        try {
            ListResponse listResponse = new ListResponse(1, 3, 3);
            listResponse.addResource(getUserResourceType());
            listResponse.addResource(getGroupResourceType());
            listResponse.addResource(getFidoDeviceResourceType());

            String json = resourceSerializer.getListResponseMapper().writeValueAsString(listResponse);
            return Response.ok(json).location(new URI(endpointUrl)).build();
        }
        catch (Exception e){
            log.error(e.getMessage(), e);
            return getErrorResponse(Response.Status.INTERNAL_SERVER_ERROR, "Unexpected error: " + e.getMessage());
        }

    }

setup()

void org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.setup ( )

inline

                       {
        //weld makes you cry if using getClass() here
        endpointUrl=appConfiguration.getBaseEndpoint() + ResourceTypeWS.class.getAnnotation(Path.class).value();
    }

translateSortByAttribute()

String org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.translateSortByAttribute ( Class<? extends BaseScimResource >  cls, String  sortBy  )

inlinepackageinherited

                                                                                          {

        String type=ScimResourceUtil.getType(cls);
        if (StringUtils.isEmpty(sortBy) || type==null)
            sortBy=null;
        else {
            if (extService.extensionOfAttribute(cls, sortBy)==null) {   //It's not a custom attribute...

                sortBy=ScimResourceUtil.stripDefaultSchema(cls, sortBy);
                Field f=IntrospectUtil.findFieldFromPath(cls, sortBy);

                if (f==null){   //Not recognized!
                    log.warn("SortBy parameter value '{}' was not recognized as a SCIM attribute for resource {} - sortBy will be ignored.", sortBy, type);
                    sortBy=null;
                    //return getErrorResponse(Response.Status.BAD_REQUEST, ErrorScimType.INVALID_PATH, "sortBy parameter value not recognized");
                }
                else {
                    sortBy = FilterUtil.getLdapAttributeOfResourceAttribute(sortBy, cls).getFirst();
                    if (sortBy==null)
                        log.warn("There is no LDAP attribute mapping to sortBy attribute provided - sortBy will be ignored.");
                }
            }
            else
                sortBy = sortBy.substring(sortBy.lastIndexOf(":")+1);
        }
        return sortBy;

    }

userResourceType()

Response org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.userResourceType ( )

inline

                                       {

        try {
            URI uri=new URI(getResourceLocation(USER_SUFFIX));
            return Response.ok(resourceSerializer.serialize(getUserResourceType())).location(uri).build();
        }
        catch (Exception e){
            log.error("Failure at userResourceType method", e);
            return getErrorResponse(Response.Status.INTERNAL_SERVER_ERROR, "Unexpected error: " + e.getMessage());
        }

    }

メンバ詳解

appConfiguration

AppConfiguration org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.appConfiguration

packageinherited

endpointUrl

String org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.endpointUrl

packageinherited

extService

ExtensionService org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.extService

private

FIDO_SUFFIX

final String org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.FIDO_SUFFIX ="FidoDevice"

staticprivate

fidoService

FidoDeviceWebService org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.fidoService

private

GROUP_SUFFIX

final String org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.GROUP_SUFFIX ="Group"

staticprivate

groupService

GroupWebService org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.groupService

private

log

Logger org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.log

packageinherited

resourceSerializer

ScimResourceSerializer org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.resourceSerializer

packageinherited

SEARCH_SUFFIX

final String org.gluu.oxtrust.ws.rs.scim2.BaseScimWebService.SEARCH_SUFFIX = ".search"

staticinherited

USER_SUFFIX

final String org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.USER_SUFFIX ="User"

staticprivate

userService

UserWebService org.gluu.oxtrust.ws.rs.scim2.ResourceTypeWS.userService

private

---

このクラス詳解は次のファイルから抽出されました:

• D:/AppData/OpenId/gluu/src/oxTrust/server/src/main/java/org/gluu/oxtrust/ws/rs/scim2/ResourceTypeWS.java