Relacionamentos - .NET SDK

Relacionamento para um

Uma relação um-para-um significa que um objeto está relacionado de uma forma específica a não mais do que um outro objeto. Você define esse relacionamento para um tipo de objeto em seu esquema de objetos especificando uma propriedade onde o tipo é o tipo de objeto de Realm relacionado.

public partial class Person : IRealmObject
{
    [PrimaryKey]
    [MapTo("_id")]
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    public DateTimeOffset Birthdate { get; set; }
    public Dog? Dog { get; set; }
}
public partial class Dog : IRealmObject
{
    [PrimaryKey]
    [MapTo("_id")]
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    public int Age { get; set; }
    public string Breed { get; set; } = String.Empty;
}

Para consultar um relacionamento direto, você pode usar a sintaxe LINQ. Consulte o exemplo a seguir para saber como consultar um relacionamento um-para-um:

var fidosPerson = realm.All<Person>().FirstOrDefault(p => p.Dog == dog);

Relacionamento com muitos

Uma relação para muitos significa que um objeto está relacionado de uma maneira específica a vários objetos. Você define esse relacionamento para um tipo de objeto especificando uma propriedade em que o tipo é um IList<T> do tipo de objeto de Realm relacionado. Defina o IList<T> apenas com um getter. Você não precisa inicializá-lo no construtor, pois o Realm gerará uma instância de collection na primeira vez que a propriedade for acessada:

// To add items to the IList<T>:
var person = new Person();
person.Dogs.Add(new Dog
{
    Name = "Caleb",
    Age = 7,
    Breed = "mutt"
});

public partial class Person : IRealmObject
{
    [PrimaryKey]
    [MapTo("_id")]
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    public DateTimeOffset Birthdate { get; set; }
    public IList<Dog> Dogs { get; }
}
public partial class Dog : IRealmObject
{
    [PrimaryKey]
    [MapTo("_id")]
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    public int Age { get; set; }
    public string Breed { get; set; } = String.Empty;
}

var katieAndHerDogs = realm.All<Person>().
    Where(p => p.Name == "Katie")
    .FirstOrDefault();

Relacionamento inverso

Um relacionamento inverso vincula um objeto a qualquer outro objeto que se refira a ele em um relacionamento definido como um-para-um ou um-para-muitos. As definições de relacionamento são unidirecionais, então você deve definir explicitamente uma propriedade no modelo do objeto como um relacionamento inverso.

Por exemplo, o relacionamento "um usuário tem muitos itens" não cria automaticamente o relacionamento inverso "um item pertence a um usuário". Se você não especificar o relacionamento inverso no modelo de objetos, você precisará executar uma query separada para procurar o usuário que é atribuído a um determinado item.

Para definir o relacionamento inverso, defina uma propriedade IQueryable<T> somente de início em seu modelo de objetos, onde T é o tipo de origem do relacionamento, e depois anote essa propriedade com um atributo [Backlink(sourceProperty)] , onde "sourceProperty" é o nome da propriedade no outro lado do relacionamento. O exemplo a seguir mostra como fazer isso com o cenário "O usuário tem muitos itens":

public partial class User : IRealmObject
{
    [PrimaryKey]
    [MapTo("_id")]
    public ObjectId Id { get; set; } = ObjectId.GenerateNewId();
    public string Name { get; set; }
    [Backlink(nameof(Item.Assignee))]
    public IQueryable<Item> Items { get; }
}
public partial class Item : IRealmObject
{
    [PrimaryKey]
    [MapTo("_id")]
    public ObjectId Id { get; set; } = ObjectId.GenerateNewId();
    public string Text { get; set; }
    public User? Assignee { get; set; }
}

Neste exemplo, observe que:

• A propriedade Assignee do objeto do item é um objeto do usuário.

• A propriedade Items do objeto do usuário inverte o relacionamento e se refere a todos os objetos do item que contêm este usuário específico em sua propriedade Assignee.

Isso, então, nos permite consultar a collection Item para obter todos os itens atribuídos a um usuário específico.

Para consultar o relacionamento inverso, você não pode usar o Linq. Em vez disso, passe um predicado de string. O exemplo a seguir mostra como você pode encontrar todos os usuários que têm itens que contêm a palavra "oscilador":

var oscillatorAssignees = realm.All<User>()
    .Filter("Items.Text CONTAINS 'oscillator'").ToList();
foreach (User u in oscillatorAssignees)
{
    Console.WriteLine(u.Name);
}