Dzielenie kodu na moduły

  • 4 min

Oprócz ułatwienia lepszego organizowania kodu moduły zapewniają również gwarancje prywatności dla wartości, typów i metod.

Przyjrzyj się temu przykładowi, w którym modelujemy uproszczony interfejs API uwierzytelniania:

mod authentication {
    pub struct User {
        username: String,
        password_hash: u64,
    }

    impl User {
        pub fn new(username: &str, password: &str) -> User {
            User {
                username: username.to_string(),
                password_hash: hash_password(password),
            }
        }    
    }
    fn hash_password(input: &str) -> u64 { /*...*/ }
}

fn main() {

    let user = authentication::User::new("jeremy", "super-secret");

    println!("The username is: {}", user.username);
    println!("The password is: {}", user.password_hash);

}

W poprzednim kodzie widać, że authentication moduł udostępnia User strukturę metodzie User::new , ponieważ są publiczne. Zwróć uwagę na pub słowo kluczowe .

Nie można skompilować tego kodu, ponieważ próbuje uzyskać dostęp do username pól i password_hash z User struktury, ale są one prywatne. Uruchomienie kodu powoduje następujący błąd:

    error[E0616]: field `username` of struct `User` is private
      --> src/main.rs:28:42
       |
    28 |     println!("The username is: {}", user.username);
       |                                          ^^^^^^^^ private field

    error[E0616]: field `password_hash` of struct `User` is private
      --> src/main.rs:29:42
       |
    29 |     println!("The password is: {}", user.password_hash);
       |                                          ^^^^^^^^^^^^^ private field

    error: aborting due to 2 previous errors

Te informacje o błędzie są przydatne, gdy chcemy kontrolować, które części naszego programu mogą uzyskiwać dostęp do każdej części danego modułu. Jeśli chcemy udzielić dostępu do odczytu do username pola i dostępu do zapisu w polu przy zachowaniu password ich prywatności, możemy użyć metod pobierania i ustawiania:

mod authentication {

    // ...

    impl User {

    // ...

        pub fn get_username(&self) -> &String {
            &self.username
        }
    
        pub fn set_password(&mut self, new_password: &str) {
            self.password_hash = hash_password(new_password)
        }
    }
}

Teraz każda próba odczytu i zapisu będzie kontrolowana authentication przez moduł .

Aby wyświetlić kod dla tej lekcji, odwiedź ten link Rust Playground.