django-json-api / django-rest-framework-json-api

JSON:API support for Django REST framework
https://django-rest-framework-json-api.readthedocs.org/
BSD 2-Clause "Simplified" License
1.18k stars 294 forks source link

JSONRenderer does not extract includes from PolymorphicModelSerializer properly #1190

Open dmuseychuk-invgate opened 9 months ago

dmuseychuk-invgate commented 9 months ago

When using PolymorphicModelSerializer with JSONRenderer, the extract_included method is retrieving the base polymorphic serializer instead of the specific serializer corresponding to the object instance. This results in the includes not being processed correctly, as the base polymorphic serializer is not equipped to handle the specifics of each derived instance.

It appears that the issue can be resolved by modifying the render method to correctly identify and use the appropriate serializer based on the object instance during the rendering process. This adjustment should enable includes to function as expected with polymorphic serializers.

if serializer is not None:
    # Extract root meta for any type of serializer
    json_api_meta.update(self.extract_root_meta(serializer, serializer_data))
    if getattr(serializer, "many", False):
        ...
    else:
        if isinstance(serializer, PolymorphicModelSerializer):
            resource_instance = serializer.instance
            serializer_class = serializer.get_polymorphic_serializer_for_instance(resource_instance)
            serializer = serializer_class(resource_instance, context=serializer.context)

            fields = utils.get_serializer_fields(serializer)
            ...
sliverc commented 9 months ago

Thanks for your report. This certainly seems to be an issue. I think your proposed fixed will only work partially, though, as the default included resource will still not work.

In any case, I am very surprised that this issue only comes up now, and I am wondering how many people use Django Polymorphic and DJA together. The thing is that the integration of Django Polymorphic has not been done very well and the implementation is cluttered all over the code base and the maintainability of DJA suffered because of it. In general, Django Polymorphic is an optional feature and should not affect other users (e.g. the code path should not change for normal use because of it), but how it is implemented now it certainly does.

Before we jump into fixing this, I will start a discussion on how we should continue with Django Polymorphic support.

sliverc commented 4 months ago

I have noticed that I talked about starting a discussion on Polymorphic support within DJA, but actually never referenced it here.

So the discussion can be found at #1194 and any feedback and use cases what it is used for are very welcome.