How to declare final class in Dart to prevent extending from it?

user_4969827 0
Viewed 1177

In Java\Kotlin we have a String class that is final and immutable.

I tried to mark the class with final keyword but looks like it's not allowable.

So, I'm a little bit confusing, how to declare final class in Dart ?

Note: the case is - I want to instantiate this class outside, but forbid to extending it. So using the private constructor - it's not my case.

dart flutter
2 Answers

You can achieve this final effect from java by having a private constructor for your class, it will prevent the class from being extended, BUT it will also prevent the class from being instantiated (only in the same file both will be possible):

class MyString {
    MyString._(); // use _ for private constructor.
  
    static void print(String s) {
      print(s);
    }
}

Call with

String message = "Hello World";
MyString.print(message);

Dart considers that we are all adults, preventing class extension is hence part of the design and responsability of the developers to have clear class names, and not part of the language:

AVOID extending a class that isn’t intended to be subclassed.
If a constructor is changed from a generative constructor to a factory constructor, any subclass constructor calling that constructor will break. Also, if a class changes which of its own methods it invokes on this, that may break subclasses that override those methods and expect them to be called at certain points.

Difference of meaning for final with Java

Dart has a very simple definition of what is final: a variable in dart can only be set once, id est: is immutable.

Final and const If you never intend to change a variable, use final or const, either instead of var or in addition to a type.
A final variable can be set only once; a const variable is a compile-time constant. (Const variables are implicitly final.) A final top-level or class variable is initialized the first time it’s used.

user_31611390

Additionally to the approach of making the constructor private and instantiating your object via a static factory, you could use the package meta and annotate your final class as sealed:

  @sealed
  class Z{}

This will signal users of your package that this class should not be extended or implemented. For example in vscode trying to extend the class Z:

  class Z1 extends Z{}

results in the following warning:

The class 'Z' shouldn't be extended, mixed in, 
or implemented because it is sealed.
Try composing instead of inheriting, or refer 
to its documentation for more information.dart(subtype_of_sealed_class)

The issue will also be picked up by the dart analyzer:

$ dart analyze
Analyzing test...                      0.8s

 info • lib/src/test_base.dart:3:1 • 
 The class 'Z' shouldn't be extended, mixed in, or implemented because it
 is sealed. Try composing instead of inheriting, or refer to its 
 documentation for more information. • subtype_of_sealed_class
user_125079840
Related