Java Link类代码示例

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
/**
 * Retrieve a link by its relationship.
 * @param entity cannot be <code>null</code>.
 * @param rel cannot be <code>null</code> or empty.
 * @return the located link or <code>null</code> if not found.
 */
public static Link getLinkByRel(Entity entity, String... rel) {
    if(entity == null) {
        throw new IllegalArgumentException("entity cannot be null.");
    }
    if(ArrayUtils.isEmpty(rel)) {
        throw new IllegalArgumentException("rel cannot be null or empty");
    }
    List<Link> links = entity.getLinks();
    if (links == null)
        return null;
    Link link = null;
    for (Link l : links) {
        if (ArrayUtils.isNotEmpty(l.getRel()) && ArrayUtils.toString(rel).equals(ArrayUtils.toString(l.getRel()))) {
            link = l;
            break;
        }
    }
    return link;
}
 

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
@Test
//@Ignore
public void testNoResolveTokens() throws Exception {
    // tokens with square brackets around the key should not be resolved to
    // the value
    // they should only end up as normal tokens themselves with square
    // brackets removed.
    Entity ent = ReflectingConverter.newInstance().toEntity(getTestCourse());
    Entity authorsEnt = ComponentUtils.getSubEntityByRel(ent, "authors2");
    // Check to be sure that both normal and parent. tokens get resolved
    // correctly.
    // Resolving: /authors?courseid={parent.courseid}/{offset} where
    // parent.courseid is the course object's field and offset is the
    // collection resources
    // field.
    String expected = "/authors?courseid=testCourseID1/{offset}";
    Link selfLink = ComponentUtils.getLinkByRel(authorsEnt, "self");
    assertEquals(expected, selfLink.getHref());
}
 

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
public Object assemble() {
    return EntityBuilder.newInstance().
            setComponentClass("entry-point").
            addLink(LinkBuilder.newInstance().
                    setHref(selfHref()).
                    setRelationship(Link.RELATIONSHIP_SELF).
                    build()).
            addLink(LinkBuilder.newInstance().
                    setHref(HotelsResource.selfURI(uriInfo).toString()).
                    setRelationship("hotels").
                    build()).
            addLink(LinkBuilder.newInstance().
                    setHref(BookingsResource.selfURI(uriInfo).toString()).
                    setRelationship("bookings").
                    build()).
            build();
}
 

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
protected EntityBuilder builder() {
    return EntityBuilder.newInstance().
            setComponentClass("booking").
            addProperty("roomType", booking.getPlace().getCategory().name()).
            addProperty("price", booking.getPrice()).
            addProperty("checkIn", booking.getCheckIn()).
            addProperty("checkOut", booking.getCheckOut()).
            addProperty("includeBreakfast", booking.isIncludeBreakfast()).
            addProperty("paid", booking.getPayment() != null).
            addLink(LinkBuilder.newInstance().
                    setHref(selfHref()).
                    setRelationship(Link.RELATIONSHIP_SELF).
                    build()).
            addLink(LinkBuilder.newInstance().
                    setHref(HotelResource.selfURI(booking.getPlace().getHotel(), uriInfo).toString()).
                    setRelationship("hotel").
                    build());
}
 

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
/**
 * Add the self link to the entity.
 *
 * @param builder assumed not <code>null</code>.
 * @param resolvedUri the token resolved uri. Assumed not blank.
 */
private void handleSelfLink(EntityBuilder builder, String resolvedUri) {
    if (StringUtils.isBlank(resolvedUri)) {
        return;
    }
    Link link = LinkBuilder.newInstance().setRelationship(Link.RELATIONSHIP_SELF).setHref(resolvedUri).build();
    builder.addLink(link);
}
 

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
/**
 * Add the baseUri link to the entity if the baseUri is set on the entity.
 *
 * @param builder assumed not <code>null</code>.
 * @param baseUri the token resolved uri. Assumed not blank.
 */
private void handleBaseUriLink(EntityBuilder builder, String baseUri) {
    if (StringUtils.isBlank(baseUri)) {
        return;
    }
    Link link = LinkBuilder.newInstance().setRelationship(Link.RELATIONSHIP_BASEURI).setHref(baseUri).build();
    builder.addLink(link);
}
 

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
/**
 * Convert a link annotation to an actual link. The href will not be resolved in the instantiated link, this will need
 * to be post processed.
 *
 * @param linkAnno assumed not <code>null</code>.
 * @return new link, never <code>null</code>.
 */
private Link annotationToLink(Siren4JLink linkAnno, EntityContext context) {
    LinkBuilder builder = LinkBuilder.newInstance().setRelationship(linkAnno.rel()).setHref(linkAnno.href());
    if (StringUtils.isNotBlank(linkAnno.title())) {
        builder.setTitle(linkAnno.title());
    }
    if (ArrayUtils.isNotEmpty(linkAnno.linkClass())) {
        builder.setComponentClass(linkAnno.linkClass());
    }
    return builder.build();
}
 

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
@Override
protected void validate(Link obj) {
    String requiredMsg = "Required property.";
    if (obj.getRel() == null || ArrayUtils.isEmpty(obj.getRel())) {
        throw new Siren4JBuilderValidationException("rel", obj.getClass(), requiredMsg);
    }
    if (obj.getHref() == null) {
        throw new Siren4JBuilderValidationException("href", obj.getClass(), requiredMsg);
    }
}
 

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
/**
 * Add a link to the entity to be built. Links are optional according to the Siren specification, however
 * an entity should always have a 'self' link to be considered HATEAOS compliant.
 * @param link cannot be <code>null</code> or empty.
 * @return <code>this</code> builder, never <code>null</code>.
 */
public EntityBuilder addLink(Link link) {
	if(link == null) {
		throw new IllegalArgumentException("link cannot be null.");
	}
	addStep("_addLink", new Object[] { link }, true);
    return this;
}
 

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
/**
 * Adds list of links to the entity to be built. Links are optional according to the Siren specification, however
 * an entity should always have a 'self' link to be considered HATEAOS compliant.
 * @param links cannot be <code>null</code>, may be empty.
 * @return <code>this</code> builder, never <code>null</code>.
 */
public EntityBuilder addLinks(List<Link> links) {
	if(links == null) {
		throw new IllegalArgumentException("links cannot be null.");
	}
    for (Link link : links) {
        addLink(link);
    }
    return this;
}
 

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
@Test
//@Ignore
public void testSubEntityOverrideLinks() throws Exception {
    Entity ent = ReflectingConverter.newInstance().toEntity(getTestCourse());
    Entity subEnt = ComponentUtils.getSubEntityByRel(ent, "firstComment");

    assertNotNull("Should have found sub entity with rel equal to 'firstComment'", subEnt);

    Link courseLink = ComponentUtils.getLinkByRel(subEnt, "course");
    assertEquals("/courses/testCourseID1/overridden", courseLink.getHref());

    Link fooLink = ComponentUtils.getLinkByRel(subEnt, "foo");
    assertNotNull("Expected to find a link named 'foo'", fooLink);

}
 

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
@Test
//@Ignore
public void testDynamicLinksOverride() throws Exception {
    Course course = getTestCourse();
    String overriddenHref = "/overridden";
    List<Link> dynamicLinks = new ArrayList<Link>();
    dynamicLinks.add(LinkBuilder.newInstance().setRelationship("reviews").setHref(overriddenHref).build());
    course.setEntityLinks(dynamicLinks);

    Entity ent = ReflectingConverter.newInstance().toEntity(course);

    Link reviewsLink = ComponentUtils.getLinkByRel(ent, "reviews");
    assertEquals(overriddenHref, reviewsLink.getHref());
}
 

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
@Test
//@Ignore
public void testResolveTokens() throws Exception {
    Entity ent = ReflectingConverter.newInstance().toEntity(getTestCourse());
    Entity authorsEnt = ComponentUtils.getSubEntityByRel(ent, "authors");
    // Check to be sure that both normal and parent. tokens get resolved
    // correctly.
    // Resolving: /authors?courseid={parent.courseid}/{offset} where
    // parent.courseid is the course object's field and offset is the
    // collection resources
    // field.
    String expected = "/authors?courseid=testCourseID1/10";
    Link selfLink = ComponentUtils.getLinkByRel(authorsEnt, "self");
    assertEquals(expected, selfLink.getHref());
}
 

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
@Test
public void testBuild() throws Exception {
	Link selfLink = LinkBuilder.newInstance()
			.setRelationship(Link.RELATIONSHIP_SELF)
			.setHref("/self/link")
			.build();
	Collection<Integer> coll = new ArrayList<Integer>();
	coll.add(4);
	coll.add(5);
	coll.add(6);
	
	Map<String, String> map = new HashMap<String, String>();
	map.put("key1", "foo");
	map.put("key2", "bar");
	Entity result = builder
			.setComponentClass("test")
			.addProperty("foo", "hello")
			.addProperty("number", 1)
			.addProperty("array", new String[] {"hey", "this", "is", "array"})
			.addProperty("collection", coll)
			.addProperty("map", map)
			.addLink(selfLink)
			.build();
	assertEquals("test", result.getComponentClass()[0]);
	assertEquals(5, result.getProperties().size());
	assertTrue(result.getProperties().containsKey("number"));
	System.out.println(result.toString());
}
 

import com.google.code.siren4j.component.Link; //导入依赖的package包/类
@Test
public void testNormalBuild() throws Exception {
	LinkBuilder builder = LinkBuilder.newInstance();
	
	String path = "/some/path";
	Link result = builder.setRelationship(Link.RELATIONSHIP_SELF)
	.setHref(path)
       .setTitle("someTitle")
	.build();
	
	assertEquals(Link.RELATIONSHIP_SELF, result.getRel()[0]);
       assertEquals("someTitle", result.getTitle());
	assertEquals(path, result.getHref());
	
}