Examples of org.lilyproject.repository.api.Link

org.lilyproject.repository.api.Link
A link to another record.
The difference between a Link and a RecordId is that a Link can be relative. This means that the link needs to be resolved against the context it occurs in (= the record it occurs in) in order to get the actual id of the record it points to.
About relative links

As an example, suppose we have a record with a variant property 'language=en'. In this record, we want to link to another record, also having the 'language=en'. By using Link, we can specify only the master record ID of the target record, without the 'language=en' property. The 'language=en' will be inherited from the record in which the link occurs. The advantage is that if the link is copied to another record with e.g. 'language=fr', the link will automatically adjust to this context.
Links have the following possibilities to specify the relative link:
- the master record id itself is optional, and can be copied (= inherited) from the context.
- it is possible to specify that all variant properties from the context should be copied. This is specified by the "copyAll" property of this object.
- it is possible to specify individual properties. For each individual property, you can specify one of the following:
  - an exact value
  - copy the value from the context (if any). This allows to selectively copy some variant properties from the context. This only makes sense when not using copyAll.
  - remove the value, if it would have been copied from the context. This is useful if you want to copy all variant properties from the context (not knowing how many there are), except some of them.
Creating links

If you just want a link to point to an exact record id, use the constructor new Link(recordId, false).
To have a link that copies variant properties from the context, use: new Link(recordId).
In such cases you might want to consider creating the link based only on the master record id new Link(recordId.getMaster()).
The Link class is immutable after construction. You have to either pass all properties through constructor arguments, or use the LinkBuilder class obtained via {@link #newBuilder}.
Example using LinkBuilder:
```
 RecordId recordId = ...; Link link = Link.newBuilder().recordId(recordId).copyAll(false).copy("dev").set("foo", "bar").create(); 
```
Resolving links to RecordId's

To resolve a link to a RecordId, using the {@link #resolve(RecordId,IdGenerator)} method.

    }


    @Test
    public void testFromString_WithTable_WithColonsInId() {
        String idString = "mytable:USER.12:34";
        Link link = Link.fromString(idString, idGenerator);


        assertEquals("mytable", link.getTable());
        assertEquals("USER.12:34", link.getMasterRecordId().toString());
    }

View Full Code Here

    }


    @Test
    public void testFromString_NoTable_WithColonsInId() {
        String idString = "USER.12:34";
        Link link = Link.fromString(idString, idGenerator);


        assertNull(link.getTable());
        assertEquals("USER.12:34", link.getMasterRecordId().toString());
    }

View Full Code Here

        varProps.put("branch", "dev");


        RecordId masterRecordId = idGenerator.newRecordId("123");
        RecordId recordId = idGenerator.newRecordId(masterRecordId, varProps);


        Link link = Link.newBuilder().recordId(recordId).copyAll(false).create();
        assertEquals(masterRecordId, link.getMasterRecordId());
        assertEquals("USER.123.!*,branch=dev,lang=en", link.toString());
        assertEquals(link, Link.fromString(link.toString(), idGenerator));
        DataOutput dataOutput = new DataOutputImpl();
        link.write(dataOutput);
        assertEquals(link, Link.read(new DataInputImpl(dataOutput.toByteArray()), idGenerator));




        assertEquals(2, link.getVariantProps().size());
        assertEquals(Link.PropertyMode.SET, link.getVariantProps().get("lang").getMode());
        assertEquals("en", link.getVariantProps().get("lang").getValue());


        Map<String, String> ctxVarProps = new HashMap<String, String>();
        varProps.put("a", "1");
        varProps.put("b", "2");
        varProps.put("lang", "nl");


        RecordId ctx = idGenerator.newRecordId(idGenerator.newRecordId("0"), ctxVarProps);
        RecordId resolved = link.resolve(ctx, idGenerator);


        // Nothing from the context should have been copied
        assertEquals(2, resolved.getVariantProperties().size());
        assertEquals("en", resolved.getVariantProperties().get("lang"));
        assertEquals("dev", resolved.getVariantProperties().get("branch"));

View Full Code Here


    @Test
    public void testIndividualRemove() {
        RecordId recordId = idGenerator.newRecordId("123");


        Link link = Link.newBuilder().recordId(recordId).remove("lang").set("x", "1").create();
        assertEquals("USER.123.-lang,x=1", link.toString());
        assertEquals(link, Link.fromString(link.toString(), idGenerator));
        DataOutput dataOutput = new DataOutputImpl();
        link.write(dataOutput);
        assertEquals(link, Link.read(new DataInputImpl(dataOutput.toByteArray()), idGenerator));




        Map<String, String> ctxVarProps = new HashMap<String, String>();
        ctxVarProps.put("lang", "en");
        ctxVarProps.put("branch", "dev");


        RecordId ctx = idGenerator.newRecordId(idGenerator.newRecordId("0"), ctxVarProps);
        RecordId resolved = link.resolve(ctx, idGenerator);


        assertNull(resolved.getVariantProperties().get("lang"));
        assertEquals("dev", resolved.getVariantProperties().get("branch"));
        assertEquals("1", resolved.getVariantProperties().get("x"));
        assertEquals(2, resolved.getVariantProperties().size());

View Full Code Here


    @Test
    public void testIndividualCopy() {
        RecordId recordId = idGenerator.newRecordId("123");


        Link link = Link.newBuilder().recordId(recordId).copyAll(false).copy("branch").set("x", "1").create();
        assertEquals("USER.123.!*,+branch,x=1", link.toString());
        assertEquals(link, Link.fromString(link.toString(), idGenerator));
        DataOutput dataOutput = new DataOutputImpl();
        link.write(dataOutput);
        assertEquals(link, Link.read(new DataInputImpl(dataOutput.toByteArray()), idGenerator));




        Map<String, String> ctxVarProps = new HashMap<String, String>();
        ctxVarProps.put("lang", "en");
        ctxVarProps.put("branch", "dev");


        RecordId ctx = idGenerator.newRecordId(idGenerator.newRecordId("0"), ctxVarProps);
        RecordId resolved = link.resolve(ctx, idGenerator);


        assertNull(resolved.getVariantProperties().get("lang"));
        assertEquals("dev", resolved.getVariantProperties().get("branch"));
        assertEquals("1", resolved.getVariantProperties().get("x"));
        assertEquals(2, resolved.getVariantProperties().size());

View Full Code Here

        assertEquals(2, resolved.getVariantProperties().size());
    }


    @Test
    public void testLinkToSelf() {
        Link link = Link.newBuilder().create();
        assertNull(link.getMasterRecordId());
        assertEquals(".", link.toString());
        assertEquals(link, Link.fromString(link.toString(), idGenerator));
        DataOutput dataOutput = new DataOutputImpl();
        link.write(dataOutput);
        assertEquals(link, Link.read(new DataInputImpl(dataOutput.toByteArray()), idGenerator));




        Map<String, String> varProps = new HashMap<String, String>();
        varProps.put("lang", "en");
        varProps.put("branch", "dev");


        RecordId recordId = idGenerator.newRecordId(idGenerator.newRecordId("123"), varProps);


        RecordId resolved = link.resolve(recordId, idGenerator);


        assertEquals(recordId, resolved);
    }

View Full Code Here

        assertEquals(recordId, resolved);
    }


    @Test
    public void testLinkToMaster() {
        Link link = Link.newBuilder().copyAll(false).create();
        assertNull(link.getMasterRecordId());
        assertEquals(".!*", link.toString());
        assertEquals(link, Link.fromString(link.toString(), idGenerator));
        DataOutput dataOutput = new DataOutputImpl();
        link.write(dataOutput);
        assertEquals(link, Link.read(new DataInputImpl(dataOutput.toByteArray()), idGenerator));




        Map<String, String> varProps = new HashMap<String, String>();
        varProps.put("lang", "en");
        varProps.put("branch", "dev");


        RecordId recordId = idGenerator.newRecordId(idGenerator.newRecordId("123"), varProps);


        RecordId resolved = link.resolve(recordId, idGenerator);


        assertEquals(recordId.getMaster(), resolved);
    }

View Full Code Here

        varProps.put("branch", "dev");


        RecordId masterRecordId = idGenerator.newRecordId("123");
        RecordId recordId = idGenerator.newRecordId(masterRecordId, varProps);


        Link link = Link.newBuilder().recordId(recordId).copyAll(false).create();


        try {
            link.getVariantProps().put("z", null);
            fail("expected exception");
        } catch (UnsupportedOperationException e) {
            // ok
        }


        try {
            link.getMasterRecordId().getVariantProperties().put("z", "z");
            fail("expected exception");
        } catch (UnsupportedOperationException e) {
            // ok
        }

View Full Code Here


    @Test
    public void testEquals() {
        RecordId recordId1 = idGenerator.newRecordId("123");
        RecordId recordId2 = idGenerator.newRecordId("678");
        Link link1 = Link.newBuilder().recordId(recordId1).copyAll(false).create();
        Link link2 = Link.newBuilder().recordId(recordId2).copyAll(false).create();


        Assert.assertEquals(link1, link1);
        Assert.assertFalse(link1.equals(link2));


        Map<String, String> varProps1 = new HashMap<String, String>();
        varProps1.put("lang", "en");
        varProps1.put("branch", "dev");


        Map<String, String> varProps2 = new HashMap<String, String>();
        varProps1.put("lang", "fr");
        varProps1.put("branch", "dev");


        RecordId recordId3 = idGenerator.newRecordId("123", varProps1);
        RecordId recordId4 = idGenerator.newRecordId("123", varProps2);
        Link link3 = Link.newBuilder().recordId(recordId3).copyAll(false).create();
        Link link4 = Link.newBuilder().recordId(recordId4).copyAll(false).create();


        Assert.assertEquals(link3, link3);
        Assert.assertFalse(link3.equals(link4));
    }

View Full Code Here

    }


    @Test
    public void testLinkBuilder_WithTable() {
        RecordId recordId = idGenerator.newRecordId("42");
        Link link = Link.newBuilder()
                        .recordId(recordId)
                        .table("mytable")
                        .create();


        assertEquals(recordId, link.getMasterRecordId());
        assertEquals("mytable", link.getTable());
    }

View Full Code Here

0 1 2 3 4

TOP

Related Classes of org.lilyproject.repository.api.Link

org.lilyproject.indexer.batchbuild.test.BatchBuildTest

org.lilyproject.indexer.batchbuild.test.MultiRepositoryIntegrationTest

org.lilyproject.indexer.engine.test.IndexerTest

org.lilyproject.linkindex.test.LinkIndexTest

org.lilyproject.process.test.TableSplitTest

org.lilyproject.repository.api.tutorial.TutorialTest

org.lilyproject.repository.impl.compat.Lily11RecordIdDecoder

org.lilyproject.repository.impl.compat.Lily20LinkDecoder

org.lilyproject.repository.impl.test.AbstractRepositoryTest

org.lilyproject.repository.impl.test.LinkTest

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.

Examples of org.lilyproject.repository.api.Link

About relative links

Creating links

Resolving links to RecordId's

Related Classes of org.lilyproject.repository.api.Link