org.mitre.discovery.util.WebfingerURLNormalizer クラス

org.mitre.discovery.util.WebfingerURLNormalizer 連携図

静的公開メンバ関数
static UriComponents	normalizeResource (String identifier)
static String	serializeURL (UriComponents uri)

非公開メンバ関数
	WebfingerURLNormalizer ()

静的非公開変数類
static final Logger	logger = LoggerFactory.getLogger(WebfingerURLNormalizer.class)
static final Pattern	pattern

詳解

Provides utility methods for normalizing and parsing URIs for use with Webfinger Discovery.

著者

wkim

構築子と解体子

WebfingerURLNormalizer()

org.mitre.discovery.util.WebfingerURLNormalizer.WebfingerURLNormalizer ( )

inlineprivate

Private constructor to prevent instantiation.

                                         {
                // intentionally blank
        }

関数詳解

normalizeResource()

static UriComponents org.mitre.discovery.util.WebfingerURLNormalizer.normalizeResource ( String  identifier )

inlinestatic

Normalize the resource string as per OIDC Discovery.

引数

identifier

戻り値

the normalized string, or null if the string can't be normalized

                                                                         {
                // try to parse the URI
                // NOTE: we can't use the Java built-in URI class because it doesn't split the parts appropriately

                if (Strings.isNullOrEmpty(identifier)) {
                        logger.warn("Can't normalize null or empty URI: " + identifier);
                        return null; // nothing we can do
                } else {

                        //UriComponentsBuilder builder = UriComponentsBuilder.fromUriString(identifier);
                        UriComponentsBuilder builder = UriComponentsBuilder.newInstance();

                        Matcher m = pattern.matcher(identifier);
                        if (m.matches()) {
                                builder.scheme(m.group(2));
                                builder.userInfo(m.group(6));
                                builder.host(m.group(8));
                                String port = m.group(10);
                                if (!Strings.isNullOrEmpty(port)) {
                                        builder.port(Integer.parseInt(port));
                                }
                                builder.path(m.group(11));
                                builder.query(m.group(13));
                                builder.fragment(m.group(15)); // we throw away the hash, but this is the group it would be if we kept it
                        } else {
                                // doesn't match the pattern, throw it out
                                logger.warn("Parser couldn't match input: " + identifier);
                                return null;
                        }

                        UriComponents n = builder.build();

                        if (Strings.isNullOrEmpty(n.getScheme())) {
                                if (!Strings.isNullOrEmpty(n.getUserInfo())
                                                && Strings.isNullOrEmpty(n.getPath())
                                                && Strings.isNullOrEmpty(n.getQuery())
                                                && n.getPort() < 0) {

                                        // scheme empty, userinfo is not empty, path/query/port are empty
                                        // set to "acct" (rule 2)
                                        builder.scheme("acct");

                                } else {
                                        // scheme is empty, but rule 2 doesn't apply
                                        // set scheme to "https" (rule 3)
                                        builder.scheme("https");
                                }
                        }

                        // fragment must be stripped (rule 4)
                        builder.fragment(null);

                        return builder.build();
                }


        }

serializeURL()

static String org.mitre.discovery.util.WebfingerURLNormalizer.serializeURL ( UriComponents  uri )

inlinestatic

                                                             {
                if (uri.getScheme() != null &&
                                (uri.getScheme().equals("acct") ||
                                                uri.getScheme().equals("mailto") ||
                                                uri.getScheme().equals("tel") ||
                                                uri.getScheme().equals("device")
                                                )) {

                        // serializer copied from HierarchicalUriComponents but with "//" removed

                        StringBuilder uriBuilder = new StringBuilder();

                        if (uri.getScheme() != null) {
                                uriBuilder.append(uri.getScheme());
                                uriBuilder.append(':');
                        }

                        if (uri.getUserInfo() != null || uri.getHost() != null) {
                                if (uri.getUserInfo() != null) {
                                        uriBuilder.append(uri.getUserInfo());
                                        uriBuilder.append('@');
                                }
                                if (uri.getHost() != null) {
                                        uriBuilder.append(uri.getHost());
                                }
                                if (uri.getPort() != -1) {
                                        uriBuilder.append(':');
                                        uriBuilder.append(uri.getPort());
                                }
                        }

                        String path = uri.getPath();
                        if (StringUtils.hasLength(path)) {
                                if (uriBuilder.length() != 0 && path.charAt(0) != '/') {
                                        uriBuilder.append('/');
                                }
                                uriBuilder.append(path);
                        }

                        String query = uri.getQuery();
                        if (query != null) {
                                uriBuilder.append('?');
                                uriBuilder.append(query);
                        }

                        if (uri.getFragment() != null) {
                                uriBuilder.append('#');
                                uriBuilder.append(uri.getFragment());
                        }

                        return uriBuilder.toString();
                } else {
                        return uri.toUriString();
                }

        }

メンバ詳解

logger

final Logger org.mitre.discovery.util.WebfingerURLNormalizer.logger = LoggerFactory.getLogger(WebfingerURLNormalizer.class)

staticprivate

Logger for this class

pattern

final Pattern org.mitre.discovery.util.WebfingerURLNormalizer.pattern

staticprivate

初期値:

= Pattern.compile("^" +
                        "((https|acct|http|mailto|tel|device):(//)?)?" + 
                        "(" +
                        "(([^@]+)@)?" + 
                        "(([^\\?#:/]+)" + 
                        "(:(\\d*))?)" + 
                        ")" +
                        "([^\\?#]+)?" + 
                        "(\\?([^#]+))?" + 
                        "(#(.*))?" +  
                        "$"
                        )

---

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

• D:/AppData/OpenId/mitreid-connect/src/openid-connect-common/src/main/java/org/mitre/discovery/util/WebfingerURLNormalizer.java