Dart Lanuage Question - what is the meaning of <RandomWords> - flutter

what does <RandomWords> mean? what is this grammar of Dart language?
class RandomWords extends StatefulWidget {
#override
State createState() {
return new RandomWordsState();
}
}
class RandomWordsState extends State<RandomWords>{
#override
Widget build(BuildContext context) {
return new Scaffold(
);
}
}
what does <RandomWords> mean? what is this grammar of Dart language?

You are specifying what State this state is about, in the same way that when you say something like:
List<String> a;
You are saying what this List is made of.
In another words, it means the State class is a Generic class.
In the documentation of List class you will see they actually refer to it as:
List<E> class.
So, whatever type you put in the List, all of the methods related that contains E (as a argument or as a return) will have the signature adjusted accordingly, i.e.:
last ↔ E
Returns the last element.
As you can see, the last method returns the same type that the List contains, which is the expected.
The use of this is mostly for type safety, so if you try to insert a number into a List< String>, the compiler will know and will detect the mistake.
Also, if you're the one developing a Generic class, it will help avoid code duplication, because you won't have to write a implementation for each possible List type in the world.
When defining your class, you can do something as follows (Example from dart Language Tour):
abstract class Cache<T> {
T getByKey(String key);
void setByKey(String key, T value);
}
And, in their words:
In this code, T is the stand-in type. It’s a placeholder that you can think of as a type that a developer will define later.
Also, as a last tip, we can see on the documentation of the State class linked above that the generic type needs to be something that inherits from Stateful Widget, so you don't try to create a State< Int>, for example.
State < T extends StatefulWidget > class

Related

What is the meaning of the <FormState> syntax in the GlobalKey<FormState>?

I saw a code like below.
I understood formKey is defined as GlobalKey type, and basically what <FormState> is? is this type as well?
I can declare field like final formKey GlobalKey; without any errors, but when I use if (_formKey.currentState.validate()) later, flutter says validate() are not defined as methods and finally I'm confusing gramatically what <FormState> is, especially way of using <>?
Or Is this Generics? but I'm still confusing that i just learned that
we can use Generics like as type placeholder. But this code shown below seems not like that.
I'm sorry that I'm really new about class or objective programing’, and do appreciate your kindness!
class TEST extends ConsumerWidget {
final formKey GlobalKey<FormState>;
//omit
The GlobalKey represents a key that is unique across your entire Flutter app. This is used to uniquely identify elements and provide access to objects that are associated to those elements. If the widget that has the global key associated, is stateful, the key also provide access to it's state.
If you check the GlobalKey class, you'll notice that it is declared as
abstract class GlobalKey<T extends State<StatefulWidget>> extends Key {}
In your case, the FormState should be a sub-class of State, which it is. The FormState represents the state associated to your form. The FormState can be used to save, reset, and validate every FormField in your Form.
TLDR: T is a generic, specifically a class that should extend State<StatefulWidget> . In your case it is used as the return type of T? get currentState {} method and it represents the state of the associated form.
For your issue with the validate() method, you must actually write the validate() method and pass it to the validator: in the TextFormField(validate: HERE) widget. The method needs to return null if everything is ok, and the string with the validation error otherwise.
ex:
String? passwordValidator(String? value){
if(value == null || value.isEmpty){
return "Please fill this field";
}else {
return null;
}
} //This is a very dummy validator, do not use it in production.

Why do Flutter StatefulWidget subclasses need to override the default constructor?

Why do the Flutter code examples always override the default contructor but don't add anything new to it?
If the overridden constructor code just calls super, can't they NOT override the constructor and inherit the default constructor's behavior? The default constructor can handle the key parameter anyway.
e.g., https://pub.dev/packages/shared_preferences/example
class Demo extends StatefulWidget {
Demo({Key? key}) : super(key: key);
DemoState createState() => DemoState();
}
In other words, the above code should function the same as this code:
class Demo extends StatefulWidget {
DemoState createState() => DemoState();
}
because the default implementation of StatefulWidget already has the constructor:
abstract class StatefulWidget extends Widget {
const StatefulWidget({ Key? key }) : super(key: key);
No, it is important to override the constructor, here is why:
In your example, try doing this:
Demo demo = Demo(key: myKey);
If you didn't declare a constructor, this will throw an error, because you never told Demo that you wanted to be able to pass a key into it. Worse yet, look at this example
class MyParentClass {
MyParentClass({required this.value});
int value;
}
class MyChildClass extends MyParentClass {
}
If you try to make a new object of type MyChildClass, what will value be? You will get an error, in fact you won't even be able to compile this example, dart will complain that MyParentClass doesn't have a default constructor before you even compile. Because you told MyChildClass that it was ok to receive no arguments, but you told MyParentClassthat it should always receive at least one.
What if you had a class of nullable values and you wanted an inherited class to always start with null on those values? if the constructor was automatically inherited, it would be impossible to do this.
This sadly means that if you have a class with say, 10 variables, and you want to inherit from it, you will have to declare a constructor for all of those values again.
Back to StatefulWidget key terms, it is not a huge deal if you don't override your stateful widgets constructor, as key is nullable, if you don't intend to ever assign a key to your widget, it is ok to ignore creating a constructor, specially if you don't have any other value to pass to it. But remember that the reason why this is the case is because StatefulWidget understands that key will sometimes be null.

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

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.
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.
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
You can use the factory unnamed constructor along with private named constructor, like this:
class NonExtendable {
NonExtendable._singleGenerativeConstructor();
// NonExtendable();
factory NonExtendable() {
return NonExtendable._singleGenerativeConstructor();
}
#override
String toString(){
return '$runtimeType is like final';
}
}
In a client code, in the same library, or another library, an instance can be created, an example:
// Create an instance of NonExtendable
print ('${NonExtendable()}');
Trying to extend it, something like
class ExtendsNonExtendableInSameLibrary extends NonExtendable {
ExtendsNonExtendableInSameLibrary._singleGenerativeConstructor() : super._singleGenerativeConstructor();
factory ExtendsNonExtendableInSameLibrary() {
return ExtendsNonExtendableInSameLibrary._singleGenerativeConstructor();
}
}
will work in the same library (same 'source file') but not in another library, making the class NonExtendable same as 'final' in Java from the perspective of any client code.

Why is an object instantiated after its declaration?

Okay so I'm trying to learn Dart by following flutter tutorials.
In the example below, right after the object is declared, an instance of itself is "created" (or at least I think so) and I don't understand why.
class CounterDisplay extends StatelessWidget {
CounterDisplay({this.count}); // What does this line do ?
final int count;
#override
Widget build(BuildContext context) {
return Text('Count: $count');
}
}
This code is from the tutorial found on this page:
https://flutter.dev/docs/development/ui/widgets-intro#changing-widgets-in-response-to-input
The line in question is this one :
CounterDisplay({this.count});
Could someone explain to me what does this line do and why it's here?
This doesn't create an instance of the object.
It is instead what we call a "constructor". Such syntax allows specifying custom parameters that need to be passed when creating the object.
See the dart documentation on constructors for more informations.
This make argument optional when create new object, or pass the variable name when creating object .

Smart cast (automatic type promotion) using 'is' is not working

I'm using the Bloc pattern and have the following code to define my states:
import 'package:meta/meta.dart'
#immutable
abstract class UiState {}
class Loading extends UiState {}
class Success extends UiState {
Success(this.message);
final String message;
}
class Failure extends UiState {}
I try to use a UiState as follows:
class MyWidget extends StatelessWidget {
const MyWidget({
Key key,
#required this.uiState,
}) : super(key: key);
final UiState uiState;
Widget build(BuildContext context) {
if (uiState is Success) {
return Text(uiState.message);
}
...
}
}
But VSCode tells me that "The getter 'message' isn't defined for the class 'UiState'".
I've used smart casts before and they did work. But in this instance, I'm not able to figure out why it's not working.
My pubspec has the following:
environment:
sdk: ">=2.1.0 <3.0.0"
So, I assume my dart version is atleast 2.1.0.
is performs implicit type promotion only for local variables.
For a local variable, the compiler can deduce that the type of the local variable will not be change between the time that its type is checked with is and before the variable is used.
For a non-local variable, the compiler cannot easily make that guarantee. Non-local variables implicitly provide getter functions, which could be overridden by derived class and which could return different values from one access to the next.
Also see:
https://github.com/dart-lang/sdk/issues/21530
https://github.com/dart-lang/sdk/issues/34480
As an alternative to an explicit cast, you of course could store the non-local variable in a local variable first. For example:
void memberFun() {
final emp = _emp;
if (emp is Person) {
emp.firstName = 'Bob';
}
}
Note that this also applies to type promotion from nullable to non-nullable types, such as when doing if (someNullableVariable != null).
Also see https://dart.dev/tools/non-promotion-reasons for some other reasons why automatic type promotion might not occur.