# Свойства(Properties)

Хорошей практикой объектно-ориентированного программирования считается скрывать внутренние детали реализации класса (принцип сокрытия информации), поэтому вы можете производить изменения внутри без изменений во внешнем API. Один из способов - это объявить поля приватными и написать методы доступа для получения и изменения значения этих полей (геттеры и сеттеры).

Если вы программировали на Java, возможно вы подумали о чем-то вроде этого:

```csharp
class Person : Object {
    private int age = 32;

    public int get_age() {
        return this.age;
    }

    public void set_age(int age) {
        this.age = age;
    }
}
```

Этот код будет скомпилирован, но в Vala можно реализовать это проще. Проблема в том, что эти методы трудоемки. Давайте предположим, что вы хотите увеличить возраст человека на один год:

```csharp
var alice = new Person();
alice.set_age(alice.get_age() + 1);
```

Вот здесь-то свойства и включаются в игру:

```csharp
class Person : Object {
    private int _age = 32;  // подчеркивание перед именем идентификатора
    // используется для того, что бы избежать конфликта имен со свойствами

    /* Свойства */
    public int age {
        get { return _age; }
        set { _age = value; }
    }
}
```

Синтаксис должен быть знаком C# программистам. Свойство имеет блоки `get` и `set` для получения и установки его значения. `value` является ключевым словом, представляющим новое значение, которое должно быть присвоено свойству.

Теперь вы можете обратиться к свойству, как будто бы оно было public полем, но внутри будет выполняться код из блоков `get` и `set`.

```csharp
var alice = new Person();
alice.age = alice.age + 1;  //  или ещё короче:
alice.age++;
```

Если вам нужны лишь стандартные возможности, то можно записать еще короче:

```csharp
class Person : Object {
    /* Свойство с get и set, и стандартным значением */
    public int age { get; set; default = 32; }
}
```

Со свойствами вы можете поменять реализацию класса не меняя API. Например:

```csharp
static int current_year = 2525;

class Person : Object {
    private int year_of_birth = 2493;

    public int age {
        get { return current_year - year_of_birth; }
        set { year_of_birth = current_year - value; }
    }
}
```

Здесь age вычисляется на лету исходя из года рождения. Заметьте, вы можете делать не просто присваивания внутри блоков `get/set`. Вы можете обратиться к базе данных, сделать запись в лог, обновить кэш и т.д.

Если вы хотите сделать свойство только для чтения, вы должны сеттер сделать `private`:

```csharp
public int age { get; private set; default = 32; }
```

Или вы можете опустить блок `set`:

```csharp
class Person : Object {
    private int _age = 32;

    public int age {
        get { return _age; }
    }
}
```

Свойства могут иметь не только название, но и короткое описание (называется nick) и длинное описание (называется blurb). Вы можете сделать аннотацию следущим образом:

```csharp
[Description(nick = "Возраст в годах", blurb = "Это возраст человека в годах")]
    public int age { get; set; default = 32; }
```

Свойства и их дополнительные описания можно получить во время работы программы. Некоторые программы, такие как дизайнер пользовательского интерфейса Glade используют такую информацию. Таким образом Glade может показывать понятные человеку описания свойств виджетов GTK+.

Каждый объект класса, наследующего от GLib.Object имеет сигнал notify. Этот сигнал подается всякий раз, когда значение свойства изменяется, поэтому вы можете подключится к этому сигналу, если требуется получать такие уведомления:

```csharp
obj.notify.connect((s, p) => {
    stdout.printf("Свойство '%s' было изменено!\n", p.name);
});
```

`s` служит источником сигнала, `p` - информация об изменившемся свойстве типа `ParamSpec`. Если вам нужно уведомление только об определенных свойствах, используйте следующих синтаксис:

```csharp
alice.notify["age"].connect((s, p) => {
    stdout.printf("возраст изменился\n");
});
```

Заметьте, что здесь нужно использовать строковое представление свойства, где подчеркивания становятся дефисами: my\_property\_name превратится "my-property-name", что соответсвует именованию свойств в GObject.

Изменить напоминания можно с помощью атрибута CCode прямо перед объявлением свойства:

```csharp
public class MyObject : Object {
    [CCode(notify = false)]
    // сигнал уведомления НЕ подается, когда произойдет изменение значения свойства
    public int without_notification { get; set; }
    // сигнал уведомления подается при изменении свойства
    public int with_notification { get; set; }
}
```

Есть еще один тип свойств называемые свойства конструктора. Они описаны далее в разделе о конструкторах в стиле `gobject.`

Note: in case your property is type of struct, to get the property value with Object.get(), you have to declare your variable as example below

```csharp
struct Color
{
    public uint32 argb;

    public Color() { argb = 0x12345678; }
}

class Shape: GLib.Object
{
    public Color c { get; set; default = Color(); }
}

int main()
{
    Color? c = null;
    Shape s = new Shape();
    s.get("c", out c);
}
```

This way, c is an reference instead of an instance of Color on stack. What you passed into s.get() is "Color *\*" instead of "Color* ".


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://vala.gitbook.io/vala/english/untitled/oop/properties.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.